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Foreword 

Dear reader, you now have a new version of the MUNIX User’s Manual in your 
hands. We have pul a great effort in it, proofread it many times, and run several 
checkers on it to verify the consistency. But ... If you find any errors, misspel¬ 
ling, or any kind of strange things, please let us know it. Criticism and sugges¬ 
tions to improve this documentation are heavily welcomed. PCS and, of course, 
the users of CADMUS Systems will benefit from your reaction. 

We wish you a lot of pleasure with PCS products. 
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DK 

UH 


ACKNOWLEDGEMENTS 

The form and much of the content of this manual come from the UNIX 
Programmer's Manual—Seventh Edition (Volume 1), developed by M. D. Mcllroy. 
In addition, parts of the present manual’s contents are descended from the 
UNIX Programmer's Manual—Sixth Edition by K. Thompson and D. M. Ritchie 
(Bell Laboratories, May 1975), the UNIX/TS User's Manual—Edition 1.1 by T. A. 
Dolotta and S. B. Olsson, eds. (Bell Laboratories, Jan. 1979), and the PYIB/UNIX 
User's Manual—Release 2.0 (Bell Laboratories, June 1979). P. E. Cannata and G. 
C. Vogel rewrote Section 2 for this edition. Many members of Centers 127 and 
135, and of Laboratory 364 helped in the creation of this volume; their help is 
hereby gratefully acknowledged. 

Murray Hill, New Jersey 

T.A.D. 

S.B.O. 

A.G.P. 


MUNDC Version 1.5 


- 1 - 


February 24, 1984 
















Introduction 


INTRODUCTION 

This manual describes the features of UNIX. It provides neither a general over¬ 
view of UNIX (for that, see “The UNIX Time-Sharing System," BSTJ, Vol. 57, No. 6, 
Part 2, pp. 1905-29, by D. M. Ritchie and K. Thompson), nor details of the imple¬ 
mentation of the system (see "UND( Implementation,” BSTJ, same issue 
pp. 1931-46). 

Not all commands, features, and facilities described in this manual are available 
in every UNIX sy.stem: for example, i/acc(l) is usually not available in a UNIX sys¬ 
tem running on a POP-11/23. When in doubt, consult your system's administra¬ 
tor. 

This manual is divided into eight sections, some containing inter-filed sub¬ 
classes: 

1. Commands and Application Programs: 

1. General-Purpose Commands. 

IB. Berkeley Extensions. 

IC. Communications Commands. 

IG. Graphics Commands. 

IM. System Maintenance Commands. 

IN. Newcastle Connection 

2. System Calls. 

3. Subroutines: 

3C. C and Assembler Library Routines. 

3F. Fortran Library Routines. 

3M. Mathematical Library Routines. 

3S. Standard I/O Library Routines. 

3X. Miscellaneous Routines. 

4. Special Files. 

5. File Formats. 

6. Games. 

7. Miscellaneous Facilities. 

8. System Maintenance Procedures. 

Section 1 {Commands and Application Programs) describes programs intended 
to be invoked directly by the user or by command language procedures, as 
opposed to subroutines, which are intended to be called by the user’s programs. 
Commands generally reside in the directory /bin (for binary programs). Some 
programs also reside in /usr/bin, to save space in /bin. These directories are 
searched automatically by the command interpreter called the shell. Sub-class 
IC contains communication programs such as cu. These entries may differ 
from system to system. Sub-class IM contains system maintenance programs 
such as fsck, mkfs, etc., which generally reside in the directory /etc; these 
commands are not intended for use by the ordinary user due to their privileged 
nature. Some UNIX systems have a directory called /usr/local, containing local 
commands. 

Section 2 {System Calls) describes the entries into the UNIX supervisor, includ¬ 
ing the C language interface. 
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Section 3 (Siibroutines) describes the available subroutines. Their binary ver¬ 
sions reside in various system libraries in the directories /lib and /usr/lib. See 
intro(3) for descriptions of these libraries and the files in which they are 
stored. 

Section 4 (Special flies) discusses the characteristics of each system file that 
actually refers to an input/output device. The names in this section generally 
refer to the Digital Equipment Corporation's device names for the hardware, 
rather than to the names of the special files themselves. 

Sections (file Formats) documents the structure of particular kinds of files; 
for example, the format of the output of the link editor is given in a.out(5). 
Excluded are files used by only one command (for example, the assembler's 
intermediate files). In general, the C language struct declarations correspond¬ 
ing to these formats can be found in the directories /usr/include and 
/usr/include/sys. 

Sections (Games) describes the games and educational programs that, as a 
rule, reside in the directory /usr/games. 

Section 7 (Miscellaneovs Facilities) contains a variety of things. Included are 
descriptions of character sets, macro packages, etc. 

Section 8 (System Maintenance Procedures) discusses crash recovery and boot 
procedures, etc. Information in this section is not of great interest to most 
users. 

Each section consists of a number of independent entries of a page or so each. 
The name of the entry appears in the upper corners of its pages. Entries within 
each section are alphabetized, with the exception of the introductory entry 
that begins each section. The page numbers of each entry start at 1. Some 
entries may describe several routines, commands, etc. In such cases, the entry 
appears only once, alphabetized under its "major" name. 

All entries are based on a common format, not all of whose parts always appear: 

The NAME part gives the name(s) of the entry and briefly states its purpose. 

The SYNOPSIS part summarizes the use of the program being described. A 
few conventions are used, particularly in Section 1 (Commands): 

Boldface strings are literals and are to be typed just as they appear. 

Italic strings usually represent substitutable argument prototypes and 
program names found elsewhere in the manual (they are underlined in 
the typed version of the entries). 

Square brackets [] around an argument prototype indicate that the 
argument is optional. When an argument prototype is given as "name” 
or "file”, it always refers to a file name. 

Ellipses ... are used to show that the previous argument prototype may 
be repeated. 
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A final convention is used by the commands themselves. An argument 
beginning with a minus —. plus +. or equal sign = is often taken to be 
some sort of flag argument, even if it appears in a position where a file 
name could appear. Therefore, it is unwise to have files whose names 
begin with —, +, or =. 

The DESCRIPTION part discusses the subject at hand. 

The EXAMPLE(S) part gives example(s) of usage, where appropriate. 

The FILES part gives the file names that are built into the program. 

The SEE Al^O part gives pointers to related information. 

The DIAGNOSTICS part discusses the diagnostic indications that may be pro¬ 
duced. Messages that are intended to be self-explanatory are not listed. 

The WARNINGS part points out potential pitfalls. 

The BUGS part gives known bugs and sometimes deficiencies. Occasionally, 

the suggested fix is also described. 

A table of contents and a permuted index derived from that table precede Sec¬ 
tion 1. On each index line, the title of the entry to which that line refers is fol¬ 
lowed by the appropriate section number in parentheses. This is important 
because there is considerable duplication of names among the sections, arising 
principally from commands that exist only to exercise a particular system call. 

On most systems, all entries are available on-line via the man(l) command, q.v. 
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HOW TO GET STARTED 

This discussion provides the basic information you need to get started on UNIX: 
how to log in and log out, how to communicate through your terminal, and how 
to run a program. (See UNIX for Beginners by B. W. Kernighan for a more com¬ 
plete introduction to the system.) 

Logging in. You must dial up UNIX from an appropriate terminal. UNIX supports 
full-duplex ASCII terminals. You must also have a valid user name, which may be 
obtained (together with the telephone number(s) of your UNIX system) from the 
administrator of your system. Common terminal speeds are 10, 15, 30, and 120 
characters per second (110, 150, 300, and 1,200 baud); occasionally, speeds of 
240, 480, and 960 characters per second (2,400, 4,800, and 9,600 baud) are also 
available. On some UNIX systems, there are separate telephone numbers for 
each available terminal speed, while on other systems several speeds may be 
served by a single telephone number. In the latter case, there is one "pre¬ 
ferred” speed; if you dial in from a terminal set to a different speed, you will be 
greeted by a string of meaningless characters (the login: message at the wrong 
speed). Keep hitting the "break” or “attention" key until the login: message 
appears. Hard-wired terminals usually are set to the correct speed. 

Most terminals have a speed switch that should be set to the appropriate speed 
and a half-/full-duplex switch that should be set to full-duplex. When a connec¬ 
tion (at the speed of the terminal) has been established, the system types login: 
and you then type your user name followed by the "return" key. If you have a 
password (and you should!), the system asks for it, but does not print ("echo”) 
it on the terminal. After you have logged in, the “return”, “new-line”, and 
"line-feed” keys will give exactly the same result. 

It is important that you type your login name in lower case if possible; if you 
type upper-case letters, UNIX will assume that your terminal cannot generate 
lower-case letters and that you mean all subsequent upper-case input to be 
treated as lower case. V/hen you have logged in successfully, the shell will type 
a S to you. (The shell is described below under How to run a program.) 

For more information, consult login{l) and getty{B), which discuss the login 
sequence in more detail, and sffy(l), which tells you how to describe the 
characteristics of your terminal to the system {profile {5) explains how to 
accomplish this last task automatically every time you log in). 

Logging out. There are two ways to log out: ' 

1. You can simply hang up the phone. 

2. You can log out by typing an end-of-file indication (ASCII EOT character, 
usually typed as ”control-z”) to the shell. The shell will terminate and 
the login: message will appear again. 

How to communicate through your terminal. When you type to UNIX, a gnome 
deep in the system is gathering your characters and saving them. These char¬ 
acters will not be given to a program until you type a "return” (or "new-line”), 
as described above in Logging in. 

UNIX terminal input/output is full-duplex. It has full read-ahead, which means 
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that you can type at any time, even while a program is typing at you. Of course, 
if you type during output, the output will have interspersed in it the input char¬ 
acters. However, whatever you type will be saved and interpreted in the correct 
sequence. There is a limit to the amount of read-ahead, but it is generous and 
not likely to be exceeded unless the system is in trouble. When the read-ahead 
limit is exceeded, the system throws away all the saved characters. 

On an input line from a terminal, the character "control-x" “kills" all the char¬ 
acters typed before it. The character ’’backspace” erases the last character 
typed. Successive uses of ’’backspace” will erase characters back to, but not 
beyond, the beginning of the line. These default erase and kill characters can 
be changed; see sfft/(l). 

The ASCII DC3 (control-s) character can be used to temporarily stop output. It is 
useful with CRT terminals to prevent output from disappearing before it can be 
read. Output is resumed when a DCl (control-q) or a second DC3 (or any other 
character, for that matter) is typed. The DCl and DC3 characters are not 
passed to any other program when used in this manner. 

The character ”control-c” is not passed to programs, but instead generates an 
interrupt signal, just like the “break”, “interrupt”, or “attention” signal. This 
signal generally causes whatever program you are running to terminate. It is 
typically used to stop a long printout that you don't want. However, programs 
can arrange either to ignore this signal altogether, or to be notified when it 
happens (instead of being terminated). The editor ed{l), for example, catches 
interrupts and stops what it is doing, instead of terminating, so that an inter¬ 
rupt can be used to halt an editor printout without losing the file being edited. 

The quit signal is generated by typing the character ”control-y”. It not only 
causes a running program to terminate, but also generates a file with the “core 
image” of the terminated process. Quit is useful for debugging. 

Besides adapting to the speed of the terminal, UNIX tries to be intelligent as to 
whether you have a terminal with the “new-line” function, or whether it must 
be simulated with a “carriage-return” and “line-feed" pair. In the latter case, 
all input “carriage-return” characters are changed to “line-feed” characters 
(the standard line delimiter), and a “carriage-return” and "line-feed” pair is 
echoed to the terminal. If you get into the wrong mode, the sf<y(l) command 
will rescue you. 

Tab characters are used freely in UNIX source programs. If your terminal does 
not have the tab function, you can arrange to have tab characters changed into 
spaces during output, and echoed as spaces during input. Again, the sf<y(l) 
command will set or reset this mode. The system assumes that tabs are set 
every eight character positions. The fa6s(l) command will set tab stops on 
your terminal, if that is possible. 

How to run a program. When you have successfully logged into UNIX, a program 
called the shell is listening to your terminal. The shell reads the lines you type, 
splits them into a command name and its arguments, and executes the com¬ 
mand. A command is simply an executable program. Normally, the shell looks 
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first in your current directory (see The current directory below) for a program 
with the given name, and if none is there, then in system directories. There is 
nothing special about system-provided commands except that they are kept in 
directories where the shell can find them. You can also keep commands in your 
own directories and arrange for the shell to find them there. 

The command name is the first word on an input line to the shell; the command 
and its arguments are separated from one another by space and/or tab charac¬ 
ters. 

When a program terminates, the shell will ordinarily regain control and type a S 
at you to indicate that it is ready for another command. The shell has many 
other capabilities, which are described in detail in s/i.(l). 

The current directory. UNIX has a file system arranged in a hierarchy of direc¬ 
tories. When the system administrator gave you a user name, he or she also 
created a directory for you (ordinarily with the same name as your user name, 
and known as your Login or home directory). When you log in, that directory 
becomes your current or working directory, and any file name you type is by 
default assumed to be in that directory. Because you are the owner of this 
directory, you have full permissions to read, write, alter, or destroy its con¬ 
tents. Permissions to have your will with other directories and files will have 
been granted or denied to you by their respective owners, or by the system 
administrator. To change the current directory use cc£(l). 

Path names. To refer to files not in the current directory, you must use a path 
name. Full path names begin with /, which is the name of the root directory of 
the whole file system. After the slash comes the name of each directory con¬ 
taining the next sub-directory (followed by a /), until finally the file name is 
reached (e.g., /usr/ae/filex refers to file filex in directory ae, while ae is itself a 
subdirectory of usr; usr springs directly from the root directory). See infro(2) 
for a formal definition of path name. 

If your current directory contains subdirectories, the path names of files 
therein begin with the name of the corresponding subdirectory {without a 
jPrefixed /). Without important exception, a path name may be used anywhere a 
file name is required. 

Important commands that modify the contents of files are C 7 )(l), Tnv(l), and 
7 mi(l), which respectively copy, move (i.e., rename), and remove files. To find 
out the status of files or directories, use ls{l). Use mkdir{\) for making direc¬ 
tories and T7nctir(l) for destroying them. 

For a fuller discussion of the file system, see the references cited at the begin¬ 
ning of the INTRODUCTION above. It may also be useful to glance through Sec¬ 
tion 2 of this manual, which discusses system calls, even if you don’t intend to 
deal with the system at that level. 

Writing a program. To enter the text of a source program into a UNIX file, use 
ed(l). The four principal languages available under UNIX are C (see cc(l)), For¬ 
tran (see f77{l)), bs (a compiler/interpreter in the spirit of Basic, see 6s(l)), 
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and assembly language (see as(l)). After the program text has been entered 
with the editor and written into a file (whose name has the appropriate suffix), 
you can give the name of that file to the appropriate language processor as an 
argument. Normally, the output of the language processor will be left in a file in 
the current directory named a.out (if that output is precious, use Tnv{l) to give 
it a less vulnerable name). If the program is written in assembly language, you 
will probably need to load with it library subroutines (see fd(l)). Fortran and C 
call the loader automatically: programs written in 6s(l) are interpreted and, 
therefore, do not need to be loaded. 

When you have finally gone through this entire process without provoking any 
diagnostics, the resulting program can be run by giving its name to the shell in 
response to the S prompt. 

If any execution (run-time) errors occur, you will need aci6(l) to examine the 
remains of your program. On the VAX-11/780, a second debugger sdb(l), which 
allows you to step through C statements rather than assembler instructions, is 
available. 

Your programs can receive arguments from the command line just as system 
programs do; see exec (2). 

Text processing. Almost all text is entered through the editor ed(l). The com¬ 
mands most often used to write text on a terminal are cat(l), pr(l), and 
nrojf(l). The caf(l) command simply dumps ASCII text on the terminal, with no 
processing at all. The pr(l) command paginates the text, supplies headings, 
and has a facility for multi-column output. JVrojf(l) is an elaborate text format¬ 
ting program, and requires careful forethought in entering both the text and 
the formatting commands into the input file; it produces output on a 
typewriter-like terminal. Troff(l) is very similar to nroff(l), but produces its 
output on a phototypesetter (it was used to typeset this manual). There are 
several "macro” packages (especially the so-called mm package) that 
significantly ease the effort required to use nroff(l) and troff(l); Section 7 
entries for these packages indicate where you can find their detailed descrip¬ 
tions. 

Surprises. Certain commands provide inter-user communication. Even if you 
do not plan to use them, it would be well to learn something about them, 
because someone else may aim them at you. To communicate with another user 
currently logged in, zurite(l) is used; mail(l) will leave a message whose pres¬ 
ence will be announced to another user when he or she next logs in. The 
corresponding entries in this manual also suggest how to respond to these two 
commands if you are their target. 

When you log in, a message-of-the-day may greet you before the first S. 
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We advise you to immediately complete this list with the upgrades and to fill the 
enclosed documents in your HUNIX binders and fo remove the outdated docu¬ 
ments as required. 


Software 

Version No. 

Date 

Remarks 

HUNDC 

1.5/01 

03.84 

delivered documentation 







Typeset 

Vl.O 

22.04.83 

delivered documentation 







sees 

Vl.O 

22.04.83 

delivered documentation 







MED 

V3.0 

03.84 

delivered documentation 







Bericeley 

Vl.l 

22.04.83 

delivered documentation 







PASeAL 

V2.2 

9.09.83 

delivered documentation 
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pti.phototypesetter interpreter 

ptx .permuted index 

pwd. working directory name 

ranlib.. . convert archives to random libraries 

ratfor.rational Fortran dialect 

readnews.i.read news articles 

rjecnews.. receive unprocessed articles via mail 
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refer.find and insert literature references in documents 

reform.reformat text file 

regcmp.• . . . . regular expression compile 

rev.reverse lines of a file 

rjeslat.HJE status report and interactive status console 

..remove files or directories 

rmdel.remove a delta from an SCCS file 

rxctrl .fioppy disk manipulating program 

sact.print current SCCS file editing activity 

sag .system activity graph 

sar.system activity reporter 

sccsdifT.compare two versions of an SCCS file 

script.make typescript of terminal session 

sdifT .side-by-side difference program 

sed.stream editor 

send.gather files and submit RJE jobs 

sh .... shell, the standard/restricted command programming language 

size..size of an object file 

sleep.. suspend execution for an interval 

sno.SNOBOL interpreter 

soelim.. eliminate .so’s from nroff input 

sort.sort or merge files 

spell..find spelling errors 

spline...interpolate smooth curve 

split ..split a file into pieces 

stctrl.special streamer features, skip files 

stksiz.set stacksize 

strings.find the printable strings in a object, or other binary, file 

strip.remove symbols and relocation bits 

struct.structure Fortran programs 

stty.set the options for a terminal 

style.analyze surface characteristics of a document 

su .become super-user or another user 

sum .sum and count blocks in a file 

tabs...set tabs on a terminal 

tail.deliver the last part of a file 

tar.tape archiver 

tbl..format tables for nroff or troff 

tc .phototypesetter simulator 

tee..pipe fitting 

test.condition evaluation command 

time . ..time a command 

timex.time a command; report process data and system activity 

tk.paginator for the Tektronix 4014 

touch.update date last modified of a file 

tplot.graphics filters 

tr.translate characters 

troff.typeset or format text 

true.provide truth values 

tsort.topological sort 

tty.get terminal name 
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ul... do underlining 

umask...set file-creation mode mask 

uname .. ..print name of current UNIX 

unget..undo a previous get of an SCCS file 

unify..unify relational data base system 

uniq.report repeated lines in a file 

units...conversion program 

uptime ..show how long system has been up 

users.. . compact list of users who are on the system 

UUCP.Unix to Unix copy 

uustat.UUCP status inquiry and job control 

uuto ..public UNDC-to-UNIX file copy 

uux..Unix to Unix command execution 

val.validate SCCS file 

vc .version control 

vfontinfo.inspect and print out information about fonts 

vi.screen oriented (visual) display editor based on ex 

w..who is on and what they are doing 

wait.await completion of process 

wc..word count 

what ...identify SCCS files 

whatis.describe what a command is 

whereis . ..locate source, binary, and or manual for program 

which ..... locate a program file including aliases and paths (csh only) 

who..who is on the system 

write..write to another user 

xargs ... construct argument list(s) and execute command 

xd...hexadecimal dump 

xref.... . cross—reference listing 

xstr.extract strings from C programs to implement shared strings 

yacc . ..yet another compiler-compiler 

yes.be repetitively affirmative 

2. System CaUs 

intro .introduction to system calls and error numbers 

access .determine accessibility of a file 

acct ...enable or disable process accounting 

alarm.. ..set a process's alarm clock 

brk.. • . change data segment space allocation 

chdir.change working directory 

chmod.change mode of file 

chown.change owner and group of a file 

chroot.. ..change root directory 

close ..close a file descriptor 

creat.. create a new file or rewrite an existing one 

dup..duplicate an open file descriptor 

exec..execute a file 

exit.. ..terminate process 

fcntl ...file control 

fork...create a new process 

getpid.get process, process group, and parent process IDs 
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getuid . . gel real user, effective user, real group, and effective group IDs 

hertz.get the line frequency on the current machine 

ioctl.control device 

kill.send a signal to a process or a group of processes 

link.link to a file 

long .system calls modified for long arguments 

Iseek.move read/write file pointer 

mknod.make a directory, or a special or ordinary file 

mount.mount a file system 

nice .change priority of a process 

open.open for reading or writing 

pause .suspend process until signal 

pipe.create an interprocess channel 

plock.lock process, text, or data in memory 

profil.execution time profile 

ptrace.process trace 

read...read from file 

setpgrp..set process group ID 

setuid .set user and group IDs 

signal.specify what to do upon receipt of a signal 

stat.get file status 

stime .set time 

sync.update super-block 

time.•.get time 

times.get process and child process times 

ulimit.get and set user limits 

umask.set and get file creation mask 

umount.unmount a file system 

uname.get name/ethernet-identification of current UNIX system 

unlink.remove directory entry 

ustat... get file system statistics 

utime.set file access and modification times 

wait.wait for child process to stop or terminate 

write.. write on a file 


3. Subroutines 


intro.. . introduction to subroutines and libraries 

a64l.convert between long and base-64 ASCII 

abort.generate an lOT fault 

abort.terminate Fortran program 

abs.integer absolute value 

abs.Fortran absolute value 

acos.Fortran arccosine intrinsic function 

aimag.Fortran imaginary part of complex argument 

aint.Fortran integer part intrinsic function 

asin.Fortran arcsine intrinsic function 

assert.verify program assertion 

atan.Fortran arctangent intrinsic function 

atan2 . . . . ’...Fortran arctangent intrinsic function 

atof..convert ASCII to numbers 

bessel. .Bessel functions 
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bip.basic functions for BIP, the PCS bitmap display 

bool.Fortran bitwise boolean functions 

bsearch.binary search 

clock...report CPU time used 

conjg ..Fortran complex conjugate intrinsic function 

conv. character translation 

cos.Fortran cosine intrinsic function 

cosh.Fortran hyperbolic cosine intrinsic function 

crypt.DES encryption 

ctermid.generate file name for terminal 

ctime...convert date and time to ASCII 

ctype. classify characters 

curses.screen functions with "optimar’ cursor motion 

cuserid ...character login name of the user 

d..text database functions 

dbm .data base subroutines 

drand48.generate uniformly distributed pseudo-random numbers 

ecvt.output conversion 

end.last locations in program 

erf.error function and complementary error function 

exp.Fortran exponential intrinsic function 

exp .exponential, logarithm, power, square root functions 

fclose.close or flush a stream 

ferror.stream status inquiries 

floor . ..floor, ceiling, remainder, absolute value functions 

fopen.*•.open a stream 

fp.Floating Point on the CADMUS 

fread..buffered binary input/output 

frexp...split into mantissa and exponent 

fgeek...reposition a stream 

_ •..walk a file tree 

ftype.explicit Fortran type conversion 

gamma...log gamma function 

getarg. • return Fortran command-line argument 

geic ....gel" character or word from stream 

getewd .get path-name of current working directory 

getenv.value for environment name 

getenv ..return Fortran environment variable 

getgrent.. ..gel- group file entry 

getlogin.g®!- login name 

getopt . ....get option letter from argv 

getpass..read a password 

getpw ..g®!- name from UID 

getpwent.... • • . get password file entry 

gets.... get a string from a stream 

getut..access utmp file entry 

hsearch .manage hash search tables 

bypot.. ..Euclidean distance function 

iarge.Number of command-line arguments 

index.return location of Fortran substring 

13tol . ..convert between 3-byte integers and long integers 
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len .return length of Fortran string 

log.Fortran natural logarithm intrinsic function 

loglO.Fortran common logarithm intrinsic function 

logname . . '.login name of user 

long.standard procedures modified for long arguments 

Isearch.linear search and update 

malloc.main memory allocator 

matherr .error-handling function 

max.Fortran maximum-value functions 

mclock.return Fortran time accounting 

min.Fortran minimum-value functions 

mktemp.make a unique file name 

mod .Fortran remaindering intrinsic functions 

monitor ..prepare execution profile 

nfcomment.a user interface to the notesfile system 

nlist .get entries from name list 

perror..system error messages 

plot.. graphics interface subroutines 

popen...initiate I/O to/from a process 

printf.. output formatters 

putc.put character or word on a stream 

putpwent .write password file entry 

puts.put a string on a stream 

qsort..quicker sort 

rand.random number generator 

rand.Fortran uniform random-number generator 

regex.regular expression compile/execute 

round..Fortran nearest integer functions 

scanf.formatted input conversion 

setbuf..assign buffering to a stream 

setjmp..non-local goto 

sign.Fortran transfer-of-sign intrinsic function 

signal ..specify Fortran action on receipt of a system signal 

sin...Fortran sine intrinsic function 

sinh.. Fortran hyperbolic sine intrinsic function 

sinh .hyperbolic functions 

sleep.suspend execution for interval 

sqrt.Fortran square root intrinsic function 

ssignal .software signals 

stdio.standard buffered input/output package 

string.string operations 

swab.swap bytes 

system.issue a shell command from Fortran 

system...issue a shell command 

tan .Fortran tangent intrinsic function 

tanh.Fortran hyperbolic tangent intrinsic function 

termcap.terminal independent operation routines 

tmpfile.create a temporary file 

tmpnam.create a name for a temporary file 

trig.;.trigonometric functions 

tsearch.manage binary search trees 
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ttyname.find name of a terminal 

ttyslot .find the slot in the utmp file of the current user 

ungetc ... . push character back into input stream 

4. Special Files 

intro...introduction to special files 

bbp.. . Basic Block Port Interface 

bip .CADMUS Bitmap Display 

confinfo .. . . table of interrupt vector and device addresses 

dz.DZ-11, DH-11 asynchronous multiplexers 

hk .RK611/RK06, RK07 moving-head disk 

hp..RP04/05/06, RM02/03 moving-head disk 

kl.. KL-11 or DL-11 asynchronous interface 

Ibp.LBP-lO Laser Beam Printer Interface 

Ip.parallel line printer 

mem..core memory 

null.the null file 

ot.TM 503/TM 603/TM 703 disk. TM 100-4 floppy disk 

pipe.Pipes and named pipes 

rk.RK-11/RK03 or RK05 disk 

rl ..RL01/RL02 moving-head disk 

rm.RM02/03/05 moving-head disk 

rx.RXOl or RX02 floppy disk 

sbp..Simplified Basic Block Port Interface 

St.SCTll Streamer interface 

termio.general terminal interface 

tm.TM-ll/TU-10 magtape interface, TS-11 magtape interface 

tty ..controlling terminal interface 

vp ...Versatec printer-plotter 

5. File Formats 

intro.introduction to file formats 

a.out.format of programs and modules 

acet.per-process accounting file format 

ahdr.format of programs and modules 

ar.archive (library) file format 

checklist.list of file systems processed by fsck 

core. format of core image file 

cpio.format of cpio archive 

dir.. ..format of directories 

dump.incremental dump format 

ethmap.. . table of ethernet addresses 

fs ..file system format of system volume 

fspec.. . format specification in text files 

gettydefs ..speed and terminal settings used by getty 

group ....group file 

inittab . ....script for the init process 

inode...format of an inode 

issue....issue identification file 

keycap.keyboard capability data base 
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mnttab...mounted file system table 

news.USENET network news article, utility files 

newsrc.information file for readnews(l) and checknews(l) 

passwd... password file 

plot.graphics interface 

profile.setting up an environment at login time 

pwmap.user and group id mappings for the Newcastle Connection 

sccsfile. format of SCCS file 

stack.C stack frame layout 

termcap .terminal capability data base 

Utah.neighbours known to the Newcastle Connection 

utmp..utmp and wtmp entry formats 

vfont .font formats for the Benson-Varian or Versatec 

6. Games 

intro.introduction to games 

arithmetic...provide drill in number facts 

back .the game of backgammon 

backgammon.the game 

banner.make long posters 

bed.convert to antique media 

bj.the game of black jack 

craps.the game of craps 

hangman..'.guess the word 

moo.guessing game 

quiz.. . test your knowledge 

reversi.reversi, a game of dramatic reversals 

rogue.Exploring The Dungeons of Doom 

startrek.THE game based on the t.v. series. 

ttt.tic-tac-toe 

wump .the game of hunt-the-wumpus 

7. Miscellaneous Facilities 

intro..introduction to miscellany 

ascii..map of ASCII character set 

environ..user environment 

eqnchar ..special character definitions for eqn and neqn 

fcntl.file control options 

greek.graphics for the extended TTY-37 type-box 

hier.file system hierarchy 

man • • •.. macros for formatting entries in this manual 

me.macros for formatting papers 

mm.the MM macro package for formatting documents 

mosd.the OSDD adapter macro package for formatting documents 

mptx.the macro package for formatting a permuted index 

ms.macros for formatting manuscripts 

mv..a macro package for making view graphs 

regexp.regular expression compile and match routines 

stat.data returned by stat system call 

term .conventional names 
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types .primitive system data types 

8. System Maintenance Procedures 

intro ..introduction to system maintenance procedures 

NCsetup.initialise the Newcastle Connection tables in a process 

acct . . overview of accounting and miscellaneous accounting commands 
acctcms .... command summary from per-process accounting records 

acctcon.connect-time accounting 

acctmerg.merge or add total accounting files 

acctprc.process accounting 

acctsh.. shell procedures for accounting 

bcopy.interactive block copy 

boot.. standalone startup program 

brc.system initialization shell scripts 

catman..create the cat files for the manual 

check..,• • • • disk checking and formatting 

checkall. ..'.... faster file system checking procedure 

chroot.change root directory for a command 

clri ...clear i-node 

crash.. crash - what to do when the system crashes 

cron .....clock daemon 

dcopy..copy file systems for optimal access time 

devnm • . . .....device name 

df ...report number of free disk blocks 

dmesg.collect system diagnostic messages to form error log 

dump.• • ..incremental file system dump 

dumpdir.. print the names of files on a dump tape 

expire ....remove outdated news articles 

fT.list file names and statistics for a file system 

filesave.daily/weekly UNIX file system backup 

format .how to format disks 

fsba.file system block analyzer 

fsck .file system consistency check and interactive repair 

fsdb . ..file system debugger 

fuser.identify processes using a file or file structure 

fwtmp.manipulate connect accounting records 

getty.set terminal type, modes, speed, and line discipline 

init.process control initialization 

install.install commands 

killall.kill all active processes 

link.exercise link and unlink system calls 

Ipd.line printer daemon 

makekey.generate encryption key 

mkalias.create an alias to a remote file 

mkfs.construct a file system 

mknod .build special file 

mksys .make a remote system node 

mount.mount and dismount file system ■ 

mvdir. move a directory 

ncheck.generate names from i-numbers 

newconf.generate configuration file and reconfigure MUNIX 
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notes..notesfile utility programs 

pstat.print system facts 

pvfck.. . password/group file checkers 

quot.summarize file system ownership 

recnews.receive unprocessed articles via mail 

renice .alter priority of running process by changing nice 

restor.incremental file system restore 

rje..HJE (Remote Job Entry) to IBM 

rmsys.remove a remote system name 

runacct.run daily accounting 

sa .system accounting 

sar.system activity report package 

sendnews.send news articles via mail 

setmnt.establish mount table 

setugi.:.alter user id of a UNIX server 

shutdown ..terminate all processing 

startnc.starts up (closes down) the file server spawner 

sync...update the super block 

unite.enable a remote user to access the local system 

usam.initiate a UNIX server for a remote client 

usrv.UNIX server for a remote client 

uuclean.uucp spool directory clean-up 

UUCP.uucp installation made easy 

uurec ....receive processed news articles via mail 

uusub .monitor uucp network 

volcopy.copy file systems with label checking 

wall.write to all users 

whatconf.what device drivers are in an unix kernel 

whodo. who is doing what 
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PERMUTED INDEX 


echo; echo arguments 
hcreate, hdestroy: manage hash search tables 
pack : packs or unpacks many files 
system: issue a shell command 
construct argument Ust(s) and execute command 
ot. ox: TU 503/TU G03/TU 703 disk. TU 
hp: handle special functions of IIP 2640 and 
hp: handle special functions of HP 
13tol, ltol3; convert between 
dirr3: 

tk: paginator for the Tektronix 
ot. ox: TU 
ot. ox: TM f503/TM 
ot. ox:TU 503/TU 603/TU 
f77: Fortran 


value. 

utime: set file 

unite: enable a remote user to 
dcopy: copy Ale systems for optimal 
getutline, pututline, setutent, endutent. utmpname: 

acct: enable or disable process 
acctconl. acctconS: connect-time 
acctprcl. acctprcS: process 
shutacct, startup, tumacct: shell procedures for 
acctdisk, acctdusg, accton, acctwtmp: overview of 
acctwtmp: overview of accounting and miscellaneous 

acct: per-process 
acctcom: search and print process 
acetmerg: merge or add total 
mclock: return Fortran time 
acetems: command summary from per-process 
fwtmp, wtmpflx: manipulate connect 
runacct: run daily 
sa, accton: system 


accounting records. 

fllc(s). 

acctconl, 

accounting and miscellaneous accounting commands, 
and miscellaneous accounting commands, acctdisk. 

miscellaneous accounting/ acctdisk. acctdusg, 

sa, 

acctprcl, 

accounting commands, acctdisk, acctdusg. accton, 

sin, cos, tan, asin, 

killall: kill all 

sag: system 
sal, sa2, sadc: system 
sar: system 

sact: print current SCCS Ale editing 
time a command; report process data and system 

mosd: the OSDD 

information: table of interrupt vector and device 
/etc/map—port—eadr: table of ethernet 

yes: be repetitively 
basename: strip Alcname 
learn: computer 
argument, 
function, 
alarm: set a process's 

/etc/mkalias: create an 
which: locate a program Ale including 


.echo(l) 

. hsearch,.hscarch(3C) 

<—> one.pack(l) 

.systcm(3S) 

. xargs: .xa.-gsCl) 

100-4 Aoppy disk.ot(4) 

C621-senes terminals.hp(l) 

2640 and 2621-series termmals.hp(l) 

3-byte integers and long integers.13tol(3C) 

3-way diAcrential Ale comparison.difr3(l) 

4014.tk(l) 

503/TM 603/TM 703 disk. Til 100-4 Aoppy disk. . . . ot(4) 

603/TlI 703 disk. Til 100-4 Aoppy disk.ot(4) 

703 disk, TM 100-4 Aoppy disk.ot(4) 

77 compiler.f77(l) 

a64l. 164a: convert between long and base-64 ASCII. . a64l(3C) 

a68: HIT assembler.a68(l) 

abort: generate an lOT fault.abort(3C) 

abort; terminate Fortran program..abort(3f) 

abs, iabs, dabs, cabs, zabs: Fortran absolute.abs(3f) 

abs: integer absolute value.abs(3C) 

access and modiAcation times.utime(2) 

access: determine accessibility of a Ale.access(2) 

access the local system. .unite(6N) 

access time..dcopy(8) 

access utmp Ale entry, getutent, getutid.getut(3C) 

accounting.acct(2) 

accounting.acctcon(8) 

accounting.acctprc(8) 

accounting, /pretmp, prdaily, prtacct, runacct, . . . acctsh(8) 
accounting and miscellaneous accounting commands. acct(8) 

accounting commands, acctdisk, acctdusg. accton. . acct(8) 

accounting Ale format. .acct(5) 

accounting Ale(s).acctcom(l) 

accounting Ales..acetmerg(8) 

accounting..mclock(3f) 

accounting records..• < ..acctcms(8) 

accounting records...fwtmp(8) 

accounting.nmacct(8) 

accounting. sa(8) 

acct: enable or disable process accounting.acct(2) 

acct: per-process accounting Ale format.acct(5) 

acctcms: command summary from per-process . . . acctcms(8) 
acctcom: search and print process accounting . . . acctcom(l) 
acctconl, acctcon2: connect-time accounting. ... acctcon(8) 

acctco.n2: connect-time accounting.acctcon(8) 

acctdisk, acctdusg. accton, acctwtmp: overview of . . acct(8) 
acctdusg, accton, acctwtmp: overview of accounting acct(8) 
acetmerg: merge or add total accounting Ales. . . . acctmerg(8) 
accton, acctwtmp: overview of accounting and .... acct(8) 

accton: system accounting.sa(fl) 

acctprcl, acctprc2: process accounting.acctprc(8) 

acctprc2: process accounting.acctprc(8) 

acctwtm.p: overview of accounting and miscellaneous acct(8) 

acos, atan, atan2: trigonometric functions.trig(3U) 

acos, dacos: Fortran arccosine intrinsic function. . . acos(3f) 

active, processes.killall(8) 

activity graph.sag(lG) 

activity report package.aar(8) 

activity reporter.sar(l) 

activity.sact(l) 

activity, timex: .timex(l) 

adapter macro package for formatting documents. . mosd(7) 

adb: debugger.adb(l) 

addresses. conAguration.conAnfo(4) 

addresses.ethmaj3(5N) 

admin: create and administer SCCS Ales.admin(l) 

aAirm.ative. 

aAixes.basename(l) 

aided instruction about UNIX.lcam(l) 

aimag, dimag: Fortran imaginary part of complex . . aimag(3f) 

aint, dint: Fortran integer part int.rinsic.aint(3f) 

alarm clock.alarm(2) 

alarm: set a process's alarm clock.alarm(2) 

alias to a remote Ale. mkalias(8N) 

aliases and paths (esh only).which(l) 
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brk, sbrk: change data segment apace allocation.brk(2) 

malloc. free, realloc, calloc: main memory allocator.malloc(3C) 

intrinsic function, log, alog, dlog, clog: Fortran natural logarithm.log(3f) 

function, log 10, aloglO, dloglO; Fortran common logarithm intrinsic . Iogl0(3f) 
renice: alter priority of running process by changing nice. . renice(8) 

/ctc/setugi: alter user id of a UNDC server.setugi(8ff) 

functions, max, maxO, amaxO, maxi, amaxl, dmaxl: Fortran maximuni*value max(3f) 
max, maxO, amaxO, maxi, amaxl, dmaxl; Fortran maximum-value functions. . max(3f) 
functions, min, minO, aminO, mini, aminl, dminl; Fortran minimum-value min(3f) 
min, minO, aminO, mini, aminl, dminl; Fortran minimum-value functions. . . min(3f) 

functions, mod, amod, dmod; Fortran remaindering intrinsic.mod(3f) 

lex; generator of lexical analysis programs.lex(l) 

error: analyse and disperse compiler error messages. . . . error(l) 

style: analyze surface characteristics of a document. . . . style(l) 

fsba: flic system block analyzer.fsba(8) 

boolean functions, and. or, xor, not, Ishift, rshift; Fortran bitwise .... bool(3f) 
functions, anint, dnint, nint, idnint; Fortran nearest integer . . round(3f) 

bed, ppt: convert to antique media.bcd(8) 

a.out; format of programs and modules.ahdr(5) 

a.out; format of programs and modules.a.out(5) 

apropos: locate commands by keyword lookup. . . . apropos(l) 

ar: arcliive and library maintainer.ar(l) 

ar; archive (library) file format.ar(5) 

be; arbitrary-precision arithmetic language.bc(l) 

acos, dacos; Fortran arccosine intrinsic function.acos(3f) 

ar; archive and library maintainer.ar(l) 

cpio: format of cpio archive.cpio(5) 

ar: arcliivc (library) file format.. ar(5) 

tar ; tape archiver.. 

cpio; copy file archives in and out.cpio(l) 

ranlib; convert archives to random libraries.ranlib(l) 

asin, dasin: Fortran arcsine intrinsic function...asin(3f) 

atan2, datan2: Fortran arctangent intrinsic function. atan2(3f) 

atan, datan: Fortran arctangent intrinsic function.. atan(3f) 

xargs: construct argument list(s) and execute command.xargs(l) 

iarge: Number of command-line arguments.. iargc(3f) 

long: system calls modified for long arguments.long(2) 

long: standard procedures modified for long arguments..long(3C) 

getopt; get option letter from argv.getopt(3C) 

be; arbitrary-precision arithmetic language.bc(l) 

arithmetic: provide drill in number facts.arithmetic(6) 

news: USENET network news article, utility flies. .news(5) 

ezpr: evaluate arguments as an expression.ezpr(l) 

as: assembler.&s(l) 

a64l. I64a: convert between long and base-64 ASCII..a64l(3C) 

ascii; map of ASCII character set.ascii(7) 

gmtime, asetime, tzset: convert date and time to ASCII, ctime, localtime.ctime(3C) 

ascii: map of ASCII character set..ascii(7) 

atof, atoi, atol: convert ASCII to numbers.atof(3C) 

ctime, localtime, gmtime, asetime, tzset; convert date and time to ASCH. . . . ctime(3C) 

sin, cos, tan, asin. acos. atan. atan2: trigonometric functions. . . trig(3ll) 

asin, dasin; Fortran arcsine intrinsic function.asin(3f) 

help: ask for help.help(l) 

a68: HIT assembler.a68(l) 

as: assembler.&s(l) 

assert; verify program assertion.assert(3X) 

assert: verify program assertion...as3ert(3X) 

setbuf: assign buffering to a stream..setbuf(3S) 

kl; KL-11 or DL-11 asynchronous interface.W(4) 

dz, dh: DZ-11, DH-11 asynchronous multiplexers.dz(4) 

sin, cos, tan, asin, acos, atan. atan2; trigonometric functions.trig(3M) 

atan, datan; Fortran arctangent intrinsic function. . atan(3f) 

function. atan2. datan2; Fortran arctangent intrinsic.atan2(3f) 

sin, cos, tan, asin, acos, atan. atan2: trigonometric functions.trig(3U) 

atof, atoi, atol; convert ASCII to numbers.atof(3C) 

atof, atoi, atol; convert ASCII to numbers.atof(3C) 

atof, atoi, atol; convert ASCII to numbers.atof(3C) 

notes, autoseq, nfpipe, nfprint, nfstats; a news system. . . . notes(l) 

wait: await completion of process.wait(l) 

awk; pattern scanning and processing language. . . . awk(l) 

ungetc: push character back into input stream... ungetc(3S) 

back; the game of backgammon.back(6) 

back; the game of backgammon.back(6) 

backgammon; the game.backgammon(6) 

fllesave, tapesave; daily/weekly UNDC file system backup.fllcsave(8) 

banner: make long posters..banner(6) 

a64l. 164a: convert between long and base-64 ASCII.a64l(3C) 

vi; screen oriented (visual) display editor baaed on ex.vi(l) 

atartrek; THE game based on the t.v. series.startrek(6) 
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Permuted Index 


bbp: 

sbp: Simplifled 
Bip; 
basic; 


shell scripts, bre. 


Ibp: LBP-10 Laser 
cb; C program 
vfont: font formats for the 
jO, jl, jn, yO, yl, yn: 

whereis: locate source, 
And the printable strings in a object, or other 
fread, fwrite: buffered 
bsearch: 

tsearch, tdelete, twalk: manage 
display. 

Bip: basic functions for 
Bip: basic functions for BIP, the PCS 
bip: CADUUS 

and. or, xor, not, Ishift, rshift: Fortran 

bj: the game of 
fsba: file system 
bcopy: interactive 
bbp: Basic 
sbp: Simplified Basic 
sync: update the super 
df: report number of free disk 
df: report number of free disk 
and. or, xor, not. Ishift, rshift: Fortran bitwise 

shell scripts. 

programs. 

fread, fwrite: 
stdio: standard 
setbuf: assign 
mknod: 
swab: swap 
cc, Icc: 
epp: the 
cb: 

indent: indent and format a 
lint: a 

xstr: extract strings from 
mkstr: create an error message file by massaging 

abs, iabs, dabs, 
fp: Floating Point on the 

dc: desk 
cal: print 

stat: data returned by stat system 

cu: 

malloc, free, realloc, 
intro: introduction to system 
link, unlink: exercise link and unlink system 

long: system 
Itroff, vtroff: troff to the 
keycap: keyboard 
termcap: terminal 

catman: create the 
uncompact, ccat: compress and uncompress flies, and 


compact, uncompact, 
cos. dcos. 


basename: strip filename affixes.bascname(l) 

basic: Basic Interpreter.basic(l) 

Basic Block Port Interface.bbp(4) 

Basic Block Port Interface. .sbp(4) 

basic functions for BIP, the PCS bitmap display. . . . bip(3) 

Basic Interpreter.basic(l) 

bbp: Basic Block Port Interface.bbp(4) 

be: arbitrary-precision arithmetic language.bc(l) 

bed, ppt; convert to antique media. .bcd(6) 

bcheckrc, rc, powerfail; system initialization ..... brc(8) 
bcopy: interactive block copy. . bcopy(0) 

bdiff: big diff.bdiff(l) 

Beam Printer Interface..lbp(4) 

beautifler.. . . . cb(l) 

Benson-Varian or Versatcc.vfont(5) 

Bessel functions. . ..bcssel(3M) 

bfs: big file scanner.bfs(l) 

binary, and or manual for program.whereis(l) 

binary, file, strings;.strings(l) 

binary input/output. .fread(3S) 

binary search.bsearch(3C) 

binary search trees. ...tsearch(3C) 

Bip: basic functions for BIP, the PCS bitmap.bip(3) 

bip: CADUUS Bitmap Display.bip(4) 

BIP, the PCS bitmap display.bip(3) 

bitmap display...bip(3) 

Bitmap Display.bip(4) 

bitwise boolean functions.bool(3f) 

bj: the game of black jack.bj(6) 

black jack.bj(6) 

block analyzer.fsba(8) 

block copy.bcopy(8) 

Block Port Interface.bbp(4) 

Block Port Interface.. sbp(4) 

block.. . . . sync(8) 

blocks..<U(1) 

blocks.df(8) 

boolean functions. .bool(3f) 

boot: standalone startup program.boot(6) 

bre, bcheckrc, rc, powerfail: system initialization . . brc(8) 
brk, sbrk: change data segment space allocation. . . brk(2) 

bs: a co.mpiler/interpreter for modest-sized.bs(l) 

bsearch: binary search.bsearch(3C) 

buffered binary input/output.fread(3S) 

buffered input/output package. . .stdio(3S) 

buffering to a stream....setbuf(3S) 

build special file.mknod(8) 

bytes. .swab(3C) 

C compiler...cc(l) 

C language preprocessor.cpp(l) 

C program beautifler. ..cb(l) 

C program source.indent(l) 

C program verifier..lint(l) 

C programs to implement shared strings.xstr(l) 

C source.mkstr(l) 

C stack frame layout.stack(5) 

cabs, zabs: Fortran absolute value.abs(3f) 

CADUUS.fp(3) 

cal: print calendar.cal(l) 

calculator.dc(l) 

calendar..cal(l) 

calendar: reminder service.calendar^ 1) 

call..stat(7) 

callUNDC. .cu(lC) 

calloc: main memory allocator.malloc(3C) 

calls and error numbers. .intro(2) 

calls.link(8) 

calls modified for long arguments.long(2) 

CANON LBP or the Versatec V80.Itroff(1) 

capability data base.keycap(5) 

capability data base...termcap(5) 

cat: concatenate and print files.cat(l) 

cat flies for the manual.catman(8) 

cat them, compact... . compact(l) 

catman: create the cat flies for the manual.catman(8) 

cb: C program beautifler.cb(l) 

cc, Icc; C compiler.cc(l) 

ccat: compress and uncompress flies, and cat them. . compact(l) 
ccos; Fortran cosine intrinsic function.cos(3f) 
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Permuted Index 


cd: change working directory.cd(l) 

* cdc: change the delta commentary of an SCCS delta, cdc(l) 

absolute value functions, floor, ceil, fmod, fabs: floor, ceiling, remainder.floor(3M) 

floor, ceil, fmod, fabs: floor, ceiling, remainder, absolute value functions.floor(3M) 

eip, dexp, cexp: Fortran exponential intrinsic function.exp(3f) 

delta: make a delta (change) to an SCCS file..delta(l) 

renice: alter priority of running process by changing nice.renice(6) 

pipe: create an interprocess channel.. pipe(2) 

real, float, sngl, dble, cmplx, dcmplx, ichar, char: explicit Fortran type conversion, /idint.ftype(3f) 

nulladm, pretmp, prdaily, prtacct, runacct,/ chargefee, ckpacct, dodisk, lastlogin, monacct, . . . acc^jh(8) 

chdir: change working directory.chdir(2) 

fsck, dfsck: file system consistency check and interactive repair.fsck(8) 

check: disk checking and formatting.check(8) 

checknn check nrofl/tro/I flies..chccknr(l) 

checknews: check to see if user has news.checknews(l) 

mmchek: check usage of mm macros and eqn delimiters. . . . mmchck(l) 

checkall: faster file system checking procedure. . . . checkall(8) 

troff. eqn, neqn, checkeq: format mathematical text for nrofl or . . . cqn(l) 

checklist; list of file systems processed by fsck. . . . checklist(5) 

checknews: check to see if user has news.checknews(l) 

newsrc: information file for readnews(l) and checknews(l).newsrc(5) 

chccknr: check nrofl/trofl files.checknr(l) 

chfn: change full name of user.chfn(l) 

chown, chgrp; change owner or group.chown(l) 

times: get process and child process times.times(2) 

wait: wait for child process to stop or terminate.wait(2) 

chmod: change mode.chmod(l) 

chmod: change mode of flic.ch.mod(2) 

chown: change owner and group of a file.chown(2) 

chown, chgrp: change owner or group.chown(l) 

chroot: change root directory.chroot(2) 

chroot: change root directory for a command.€hroot(8) 

pretmp, prdaily, prtacct, runacct,/ chargefee, ckpacct, dodisk, lastlogin, monacct, nulladm, .... acctsh(6) 
ispunct, isprint, isgraph, iscntrl, isascii: classify characters, /isxdigit, isalnum, isspace, . . . etype(3C) 

uuclean: uucp spool directory clean-up.uuclcan(8) 

clear: clear terminal screen.clear(l) 

clri: clear i-node.clri(8) 

clear: clear terminal screen.clear(l) 

terror, feof, clearerr, ftleno: stream status inquiries.ferror(3S) 

esh: a shell (command interpreter) with C-like syntax.csh(l) 

alarm: set a process's alarm clock.alarm(2) 

cron: clock daemon.cron(8) 

' clock: report CPU time used.c!ock(3C) 

log, alog, dlog, clog: Fortran natural logarithm intrinsic^function. . log(3f) 

close: close a file descriptor..*.close(2) 

close: close a flle'dcscriptor.closc(2) 

fclose, fflush: close or flush a stream..fclose(3S) 

/etc/startnc, /etc/stopnc: starts up (closes down) the file server spawner.startnc(8N) 

clri: clear i-node.clri(8) 

emp: compare two flies.cmp(l) 

int, iflx, idint. real, float, sngl, dble, cmplx, dcmplx, ichar, char: explicit Fortran type/ . ftype(3f) 

col: Alter reverse line feeds.col(l) 

colcrt: Alter nrolT output for CRT previewing.colcrt(l) 

log. dmesg: collect system diagnostic messages to form error . . dmesg(8) 

colrm: remove columns from a file.coirm(l) 

colrm: remove columns from a file.colrm(l) 

comb: combine SCCS deltas.comb(l) 

comb: combine SCCS deltas..comb(l) 

files, comm: select or reject lines common to two sorted . comm(l) 

chroot: change root directory for a command.chroot(8) 

esh: a shell (command interpreter) with C-like syntax.csh(l) 

test: condition evaluation command..test(l) 

lime: time a command.time(l).« 

getarg: return Fortran command-line argument.getarg(3f) 

large: Number of command-line arguments.large(3f) 

overview of accounting and miscellaneous accounting commands, acetdiak, acctdusg, aceton, acctwtmp: . acct(8) 

install: install commands.install(8) 

intro: introduction to commands.intro(l) 

cdc: change the delta commentary of an SCCS delta.cdc(l) 

log 10, alog 10. dlog 10: Fortran common logarithm intrinsic function.Iogl0(3f) 

comm: select or reject lines common to two sorted flies.comm(l) 

users: compact list of users who are on the system. .... users(l) 

files, and cat them, compact, uncompact, ccat: compress and uncompress compact(l) 

difi: differential file comparator..difl(l) 

emp: compare two flies..cmp(0 

scesdifT: compare two versions of an SCCS file.sccsdifT(l) 

diffS: 3-way differential fUe comparison.difT3(l) 

diremp: directory comparison.dircmp(l) 

regexp: regular expression compile and match routines.regexp(7) 


February 24. 1984 


- 4- 


MUNDC Version 1.5 


































































Permuted Index 


rcgcmp; regular expression compile.regcmp(l) 

regex, regemp; regular expression compile/execute.. regex(3X) 

cc. Icc: C compiler.cc(l) 

error: analyze and disperse compiler error messages.error(l) 

f77: Fortran 77 compiler.f77(l) 

pc; Pascal compiler.pc(l) 

yacc; yet another compiler-compiler.yacc(l) 

bs: a compiler/interpreter for modest-sized programs. . , bs(l) 

erf, erfc; error function and complementary error function.crf(3M) 

wait: await completion of process.wait(l) 

aimag, dimag: Fortran imaginary part of complex argument.aimag(3f) 

conjg, dconjg; Fortran complex conjugate intrinsic function.conjg(3f) 

compact, uncompact, ccat; compress and uncompress flies, and cat them. .... compnct(l) 

learn: computer aided instruction about UNIX.lcam(l) 

cat: concatenate and print flies.cat(l) 

test; condition evaluation command.te5t(l) 

newconf: generate configuration flle and reconflgure UUNDC.newcon/(8) 

vector and device addresses, conflguration information: table of intermpt .... conflnfo(4) 
function, conjg, dconjg: Fortran complex conjugate intrinsic . conig(3f) 

conjg, dconjg: Fortran complex conjugate intrinsic function.. conjg(3f) 

fwtmp, wtmpflx: manipulate connect accounting records.fwtmp(0) 

user and group id mappings for the Newcastle Connection, /etc/pwmap,/etc/groupmap; .pwmap(5N) 

/ctc/utab: neighbours known to the Newcastle Connection.utab(5l^ 

acctconl, acctcon2: connect-time accounting.acctcon(8) 

fsck, dfsck; flle system consistency check and interactive repair.fsck(8) 

rjestat: RJE status report and interactive status console.rjcstat(lC) 

mkfs*. construct a flle system... . mkfs(8) 

xargs: construct argument list(s) and execute command . . xargs(l) 

derofl: remove nrofl/trofT, tbl, and eqn constructs. .derofl(l) 

Is, iJ, 1, Ir, If, lx: list contents of directory..ls(l) 

esplit: context split.csplit(l) 

ioctl: control device.ioctl(2) 

. fcntl; flic control...fcntl(2) 

init, telinit: process control initialization.init(8) 

fcntl: flic control options..fcntl(7) 

uustat: uucp status inquiry and job control.uustat(lC) 

VC: version control... 

tty: controlling terminal interface.tty(4) 

term; conventional names.term(7) 

cevt, fevt: output conversion.ecvt(3C) 

cmplx, dcmplx, ichar, char: explicit Fortran type conversion, /iflx, idint. real, float, sngl, dble, ... . ftypc(3f) 

units: conversion program. .units(l) 

scanf, fscanf, sscanf: formatted input conversion..scanf(3S) 

dd: convert and copy a flle.dd(l) 

ranlib: convert archives to random libraries.ranlib(l) 

atof, atoi, atol: convert ASCII to numbers.atof(3C) 

IStol, ltol3: convert between 3-byte integers and long integers. . 13tol(3C) 

a64l, 164a: convert between long and baseT64 ASCIL.a64l(3C)‘' 

ctime, localtime, gmtime, asetime, tzset: convert date and time to ASCII.ctime(3C) 

bed, ppt: convert to antique media.bcd(6) 

dd: convert and copy a flle.d<l(l) 

bcopy: interactive block copy.bcopy(8) 

cpio: copy flle archives in and out.cpio(l) 

dcopy: copy flle systems for optimal access time.dcopy(8) 

volcopy, labelit: copy flle systems with label checking.volcopy(8) 

cp. In, mv. copy, link or move flies.cp(l) 

uucp, milog, uuname: unix to unix copy.. uucp(lC) 

uuto, uupick: public UNDC-to-UNDC flle copy.uuto(lC) 

core: format of core image flle.core(S) 

core: format of core image flle.core(5) 

mem, kmcm: core memory.mem(4) 

cos, dcos, ccos: Fortran cosine intrinsic function. . . cos(3f) 
functions, sin, cos, tan, asin, acos, atan, atan2; trigonometric . . . trig(3M) 

function, cosh, dcosh; Fortran hyperbolic cosine intrinsic . . . cosh(3f) 

sinh, cosh, tanh: hyperbolic functions.ainh(3U) 

cos, dcos, ccos: Fortran cosine intrinsic function.cos(3f) 

cosh, dcosh: Fortran hyperbolic cosine intrinsic function.cosh(3f) 

sum: sum and count blocks in a flle.sum(l) 

wc; word count.^c(l) 

cp. In, mv. copy, link or move flies.epO) 

cpio: format of cpio archive.cpio(5) 

cpio: copy flle archives in and out.. . . cpio(l) 

cpio: format of cpio archive.cpio(5) 

epp: the C language preprocessor.cpp(l) 

clock: report CPU time used.clock(3C) 

craps: the game of craps.craps(6) 

craps: the game of craps.craps(6) 

crash - what to do when the system crashes. ..... craah(8) 
crash - what to do when the system crashes.craah(8) 
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one. creat; create a new flje or rewrite an existing .... creat(2) 

umaak: set and get file creation mask.uniaak(2) 

cref: make cross-reference listing.cref(l) 

cron: clock daemon.cron(fl) 

cref; make cross-reference listing.cref(l) 

xref ; cross—reference listing.xref(l) 

colcrt: filter nrofi output for CRT previewing.colcrt(l) 

more, page: file perusal filter for ert viewing.more(l) 

crypt: encode/decode.cr 3 rpt(l) 

crypt, setkey, encrypt: DES encryption.crypt(3C) 

syntax, esh; a shell (command interpreter) with C-like .... csh(l) 

locate a program file including aliases and paths (esh only), which:.which(l) 

adn, dain, csin; Fortran sine intrinsic function.ain(3f) 

esplit: context split.capiit(l) 

sqrt, dsqrt, csqrt: Fortran square roet intrinsic function.sqrt(3f) 

ctags: create a tags file.ctags(l) 

ctermid: generate file name for terminal.ctermid(3S) 

date and time to ASCII, ctime, localtime, gmtime, asctime, txset: convert . . ctime(3C) 

cu: call UNIX.cu(lC) 

hertz: get the line frequency on the current machine.hert 2 ( 2 ) 

sact: print current SCCS file editing activity.sact(l) 

uname, cthname: get name/ethemet-identiflcation of current UNIX system....uname(2) 

uname: print name of current UNIX. uname(l) 

ttyslot: find the slot in the utmp file of the current user.ttyslot(3C) 

getewd: get path-name of current working directory.getcwd(3C) 

motion, curses: screen functions with "optimal” cursor . . . curses(3) 

curses: screen functions with "optimal” cursor motion..curses(3) 

spline: interpolate smooth curve.splinc(lG) 

cuserid: character login name of the user.cuserid(3S) 

file, cut: cut out selected fields of each line of a .cut(l) 

cut: cut out selected fields of each line of a file.cut(l) 

d : text database functions.d(3) 

d: text database functions.d(l) 

abs, iabs, dabs, cabs, zabs: Fortran absolute value.abs(3f) 

, acos, dacos: Fortran arccosine intrinsic function.acos(3f) 

cron: clock daemon.cron(8) 

Ipd; line printer daemon.lpd(8) 

runacct: run daily accounting.rjnacct(8) 

fUesave, tapesave: daily/weekly UNIX file system backup.flle3avc(8) 

asin, dasin: Fortran arcsine intrinsic function.aain(3f) 

timex: time a command; report process data and system activity.timex(l) 

dbadd: add entry to an Emacs data base.dbadd(l) 

keycap: keyboard capability data base.keycap(5) 

dbminit, fetch, store, delete, flrstkey, nextkey: data base subroutines.dbm(3X) 

unify relational data base system..unify(l) 

termcap: terminal capability data base.termcap(5) 

plock: lock process, text, or data in memory. plock(2) 

prof: display profile data..prof(l) 

stat: data returned by stat system call.. stat(7) 

brk, sbrk: change data segment space allocation.brk(2) 

types: primitive system data types.types(7) 

d: text database functions.• • • • ^(0 

d : text database functions.d(3) 

join: relational database operator.join(l) 

atan, datan: Fortran arctangent intrinsic function.atan(3f) 

atan2, datan2: Fortran arctangent intrinsic function. . . . atan2(3f) 

ctime, localtime, gmtime, asctime, tzset: convert date and time to ASCII.ctime(3C) 

date: print and set the date.date(l) 

touch: update date last modified of a file.touch(l) 

date: print and set the date.date(l) 

dbadd: add entry to an Emacs data base.dbadd(l) 

type/ int, iflx, idint, real, float, sngl, dble, cmplx, dcmplx, ichar, char: explicit Fortran . . ftype(3f) 
data base subroutines, dbminit, fetch, store, delete, flrstkey, nextkey: . . . dbm(3X) 

dc: desk calculator.dc(l) 

int, iflx, idint, real, float, sngl, dble, cmplx, dcmplx, ichar, char: explicit Fortran type/ .ftype(3f) 

function, conjg. dconjg: Fortran complex conjugate intrinsic.conjg(3f) 

dcopy: copy file systems for optimal access time. . . dcopy(8) 

cos, dcos, ccos: Fortran cosine intrinsic function.cos(3f) 

function, cosh, dcosh; Fortran hyperbolic cosine intrinsic.cosh(3f) 

dd; convert and copy a file.dd(l) 

dump, ddate: incremental dump format.dump(5) 

adb: debugger.adb(l) 

fsdb: ftle system debugger.fsdb(8) 

* eqnchar: special character dertnitions for eqn and neqn.eqnchar(7) 

dbminit, fetch, store, delete, ftrstkey, nextkey: data base subroutines. . . dbm(3X) 

mmchek: check usage of mm macros and eqn delimiters.mmchek(l) 

tail: deliver the last part of a file.tail(l) 

ede: change the delta commentary of an SCCS delta.cdc(l) 

delta; make a delta (change) to an SCCS file.delta(l) 
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cdc: change the 
rmdel; remove a 

comb: combine SCCS 
mesg : permit or 
constructs, 
crypt, setkey, encrypt: 

whatis: 
close: close a llle 
dup: duplicate an open file 
dc: 
access: 
file: 

information: table of interrupt vector and 
whatconf: what 
fold: fold long lines for finite width output 
ioctl: control 
devnm; 

exp. 


interactive repair, fsck, 
dz. 

dz, dh: DZ-11, 
dmesg: collect system 
ratfor: rational Fortran 
print wordy sentences, interactive thesaurus for 
interactive thesaurus for diction. 

bdifT: big 


sdifT: side-by-side 
difi: 

difT3: 3-way 
aimag, 
aint. 


dir: format of 
rm, rmdir ; remove files or 
cd: change working 
chdir: change working 
chroot: change root 
uuclean: uucp spool 
diremp: 
unlink: remove 
chroot: change root 
getewd: get path-name of current working 
Is, U, 1, Ir, If, Iz: list contents of 
mkdir : make a 
mvdir; move a 
pwd: working 
mknod: make a 
acet: enable or 

getty : set terminal type, modes, speed, and line 
df: report number of free 
df: report number of free 
check: 

hk: RK611 /RK06, RK07 moving-head 
hp: RP04/05/06, RM02/03 moving-head 
rxctrl: floppy 

ot, ox: TM 503/TU 603/Til 703 disk, TM 100-4 floppy 
rk ; RK-11/RK03 or RK05 
rl, hi: RL01/RL02 moving-head 
rm: Ril02/03/05 moving-head 
rx : RXOl or RX02 floppy 
ot, ox: TU 503/TU 603/TU 703 
du: summarize 
format: how to format 
mount, umount: mount and 
error: analyze and 
Bip: basic functions for BIP, the PCS bitmap 
bip: CAOUUS Bitmap 
vi: screen oriented (visual) 
prof: 

hjrpot: Euclidean 
srand46, seed46, lcong48: generate uniformly 

kl; iCL-M or 


delta commentary of an SCCS delta.cdc(l) 

delta from an SCCS flle.rmdcl(l) 

delta: make a delta (change) to an SCCS file.delta(l) 

dehtna .comb(l) 

deny messages.mesg(l) 

derofl: remove nroff/trofT, tbl, and cqn.derofT(l) 

DES encryption.crypt(3C) 

describe what a command is.whatis(l) 

descriptor.closc(2) 

descriptor.dup(2) 

desk calculator.. dc(l) 

determine accessibility of a file. access(2) 

determine file type.file(l) 

device addresses, configuration .conflnfo(4) 

device drivers are in an unix kernel.whatconf(8) 

device.fold(l) 

device.ioctl(2) 

device name.devnm(8) 

devnm: device name.devnm(8) 

dexp, cexp: Fortran exponential intrinsic function. • eip(30 

df: report number of free disk blocks.df(l) 

df; report number of free disk blocks.. df(8) 

dfsck: flle system consistency check and.fsck(8) 

dh: DZ-11, DH-11 asynchronous multiplexers.dz(4) 

DH-11 asynchronous multiplexers.dz(4) 

diagnostic messages to form error log.dmesg(8) 

dialect..ratfor(l) 

diction, diction, explain: .diction(l) 

diction, explain: print wordy sentences, .d:ction(l) 

dilT. .bdifl(l) 

difi: diflerential flle comparator.difT(l) 

difT3: 3-way diflerential file comparison.difl3(l) 

difference progra.m..sdifl(l) 

di.flerential flle comparator.difl(l) 

diflerential flle comparison.difl3(l) 

dimag: Fortran imaginary part of complex argument. aimag(3f) 

dint; Fortran integer part intrinsic function.aint(3f) 

dir: format of directories.dir(5) 

diremp; directory comparison.dircmp(l) 

directories.dir(5) 

directories.rm(l) 

directory.cd(l) 

directory.chdir(2) 

directory.chroot(2) 

directory clean-up.uuclean(8) 

directory comparison.dircmp(l) 

directory entry.unlink(2) 

directory for a command.chroot(8) 

directory.getcwd(3C) 

directory.ls(l) 

directory.mkdir(l) 

directory.mvdir(8) 

directory name.. pwd(l) 

directory, or a special or ordinary file.mknod(2) 

disable process accounting.acct(2) 

discipline.getty(8) 

disk blocks.df(l) 

disk blocks.. df (8) 

disk checking and formatting.check(8) 

disk.hk(4) 

disk.hp(4) 

disk manipulating program. .rxctrl(l) 

disk.ot(4) 

disk.rk(4) 

disk.rl(4) 

disk.rm(4) 

disk.rx(4) 

disk, TM 100-4 floppy disk.ot,(4) 

disk usage.du(l) 

disks.format(8) 

dismount flle system. .mount(8) 

disperse compiler error messages. .; . . . crror(l) 

display.... bip(3) 

Display.. ..bip(4) 

display editor based on ex.vi(l) 

display profile data.prof(l) 

distance function.hypot(3M) 

distributed pseudo-random numbers. /jrand48, . . . drand48(3C) 
DL-11 asynchronous interface.kl(4) 


UUNDC Version 1.5 


- 7- 


February 24, 1984 



















































































Permuted Index 


function, log, alog, dlog. clog: Fortran natural logarithm intrinsic .... ocW 

function, logic. aloglO. dlog 10 : Fortran common logarithm intrinsic.loglOC3f) 

max. maxO. amaxO. maxi, amasl, dmaxl: Fortran maximum-value functions. ..... max(3*) 

error log. dmcsg: collect system diagnostic messages to form . dmesg(a) 

min. mmO. aminO. mini, aminl. dminl: Fortran minimum-value functions. 

mod, amod, dmod: Fortran remaindering intrinsic functions. . . modi3f) 

functions, anint, dnint, nint, idnint: Fortran nearest integer .round(3f) 

style : analyxe surface charactehstics of a document.. .... . .. 

mm: print out documents formatted with the UU macros.mmO) 

mm: the UU macro package for formatting documents. 

mosd: the OSDD adapter macro package for formatUng documents. . ^ 

lookbib: find and insert literature references in documents, refer, • • • • • • .. 

mmt. mvt: typeset documents, view graphs, and slides.mmtu; 

prdaily. prtacct. ranacct./ chargefee. ckpacct. dodiak. lastlogin. monacct. nulladm. pretmp.acc^h(8} 

w; who is on and what they are doing. 

whodo; who is doing what.whodo(8} 

rogue: Exploring The Dungeons of Doom. .rpvr\ 

/etc/startne. /ctc/stopnc: starts up (closes down) the flle server spawner.startnc(8M} 

reversi; reversi, a game of dramatic reversals. ^ 

irand 48 , srand48. sccd48, lcong48; generate/ drand48. erand48. Irand48, nrand48. mrand48. . . . drand48(3C) 

graph: draw a graph. 

arithmetic: provide drill in number facts. 

whatconf: what device drivers are in an unix kernel.whatconf(8) 

sign, isign, dsign: Fortran transfer-of-sign intrinsic function. . sign(3f) 

sin, dsin, csin: Fortran sine intrinsic function. ..ain(3f) 

sinh, dsinh: Fortran hyperbolic sine intrinsic function. . . adnh(3f) 

function, sqrt, dsqrt, csqrt: Fortran square root intrinsic.•qrt(3f) 

tan, dtan: Fortran tangent intrinsic function.tan(3f) 

function, tanh, dtanh: Fortran hyperbolic tangent intrinsic.tanhpf) 

du: summarize disk usage.du(l) 

dump, ddate: incremental dump format.dump(5) 

dump: incremental flic system dump.. 

dump, ddate: incremental dump format..j 

dump: incremental flle system dump.dummo; 

od : octal dump.j. /a^ 

dumpdir: print the names of flies on a dump tape.dumpdir(8) 

xd : hexadecimal dump..j /o\ 

dum-pdir: print the names of flies on a dump tape. . . dumpdiria; 

rogue: Exploring The Dungeons of Doom. . .. 

dup: duplicate an open flle descriptor.dup(2) 

dup: duplicate an open file descriptor.dup(2) 

dz, dh: DZ-11, DH-11 asynchronous multiplexers. . . dz(4) 

dz. dh: DZ-11. DH-11 asynchronous multiplexers.dz(4) 

uucp: UUCP installation made easy.\ 

echo: echo arguments.\ 

echo: echo arguments. 

cevt, fevt: output conversion.ecvt(3C) 

ed, red: text editor.cd(l) 

end. etext, edata: last locations in program..cnd(3C) 

sact: print current SCCS file editing activity.' 

vi: screen oriented (visual) display editor based on ex. j}}\ 

cd, red: text editor.cdlU 

emacs: a screen editor.. 

ex: text editor.** 

med: screen editor. mea(l} 

sed: stream editor. 

get real user, cfTectivc user, real group, and eflcctive group IDs. /geteuid. getgid. getegid: .... gctuid(2) 
getuid, gctcuid, getgid. getegid: get real user, eflcctive user, real group, and effective group/ . . . getui<H2; 

efl: Extended Fortran Language.\ 

grep, egrep, fgrep: search a flle for a pattern.grep(l) 

soelim: eliminate .so's from nrofl input.soelim(l) 

emacs: a screen editor.\ 

dbadd: add entry to an Emacs data base.. • 

unite: enable a remote user to access the local system- . . umte(8N} 

acet: enable or disable process accounting.acct(2) 

crypt: encode/decode. 

crypt, seticcy, encrypt: DES encryption. 

crypt, setkey. encrypt: DES encryption. 

makekey: generate encryption key. 

end, etext, edata: last locations in program-.cnd(3C) 

getgrent, getgrgid. getgrnam, setgrent, endgrent: get group flle entry. 

getpwent, getpwuid, getpwnam, setpwent, endpwent: get password file entry. 

getutent. getutid, getutlinc, pututline, setutent. endutent, utmpname: access utmp flle entry.getut(3C} 

nlist: get entries from name list.nlist(3C) 

man, manprog: print entries in this manual. 

man: macros for formatting entries in this manual. 

rjc: RJE (Remote Job Entry) to IBM.. 

env: act environment for command execution.env(l) 

environ: user environment.cnviron(7) 
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pro!\le; setting up an environment at login time. .proflle(5) 

environ; user environment.environ(7) 

env; set environment for command execution.cnv(l) 

getenv: value for environment name. .getenv(3C) 

getcnv: return Fortran environment variable.getenv(3f) 

eqnchar: special character definitions for eqn and neqn.eqnchar(7) 

derofi; remove nrofi/trofi, tbl, and eqn constructs.. ..derofT(l) 

mmchek; check usage of mm macros and eqn delimiters.mjnchek(l) 

nrofT or troff. eqn. neqn, checkeq: format mathematical text for . . cqn(l) 

neqn. eqnchar: special character definition.^ for eqn and . eqnchar(7) 

3rand48, seedl6, lcong48; generate/ drand48, erand48, lrand48. nrand48. mrand48. jrand48, . . . drand48(3C) 

function, erf, erfc; error function and complementary error . erf(3M) 

function, erf, erfc; error function and complementary error .... erf(3M) 

perror, sys-jerrlist, sysL-nerr, errno; system error messages.perror(3C) 

messages, error: analyze and disperse compiler error.error(l) 

erf, erfc; error function and complementary error function. . crf(3M) 

erf, erfc: error function and complementary error function.erf(3M) 

dmesg: collect system diagnostic messages to form error log. .dm.esgCd) 

mi«str: create an error message file by massaging C source.mkstr(l) 

error: analyze and disperse compiler error messages.*error(l) 

perror, sys—crrlist, sys.—nerr, errno: system error m.essages.perror(3C) 

intro: introduction to system calls and error numbers.intro(2) 

matherr: error-handling function.matherr(3M) 

spell, spellin, spellout: find spelling errors.spell(l) 

setmnt: establish mount table.setmnt(8) 

Newcastle Connection, /etc/pwmap, /etc/groupmap: user and group id mappings for the pwmap(5N) 

/etc/map—port—eadr: table of ethernet addresses. . ethmap(5N) 

/etc/mkalias; create an alias to a remote file.mkalias(8N) 

/etc/mksys: make a remote system node.mksys(8N) 

tables in a process. /etc/NCsetup: initialise the Newcastle Connection . NCsetup(8N) 
mappings for the Newcastle Connection, /etc/pwmap, /etc/groupmap: user and group id . . pwmap(5N) 

/etc/rmsys: remove a remote system name. ..... rmsys(8N) 

/etc/setugi: alter user id of a UNIX server.setugi(8N) 

the file server spawner. /etc/startnc, /etc/stopnc: starts up (closes down) . startnc(8N) 

server spawner. /etc/startnc, /etc/stopnc: starts up (closes down) the file.startnc(8N) 

client. /etc/usa.m initiate a UNDC server for a remote . . . usam(8N) 

Connection, /etc/utab: neighbours known to the Newcastle . . . utab(5N) 

end, etext, edata: last locations in program. .cnd(3C) 

/etc/map—port—eadr: table of ethernet addresses.ethmap(5N) 

current UNIX system, uname, ethname: get name/ethemet-identifleation of .... uname(2) 

hypot: Euclidean distance function.hypot(3M) 

expr: evaluate arguments as an expression.«pr(l) 

test: condition evaluation command.test(l) 

ex: text editor.cx(l) 

screen oriented (visual) display editor based on ex. vi: .vi(l) 

excr : run a program on another system..excr(lN) 

execute a file, execl, exeev, execle, exeeve, execlp, exeevp:.exec(2) 

execl. exeev, execle, exeeve, execlp, exeevp: execute a ^e.exec(2) 

execl, exeev, execle, exeeve, execlp, exeevp: execute a file.exec(2) 

execl, exeev, execle. exeeve, execlp, exeevp: execute a file.exec(2) 

xargs: construct argument liat(s) and execute command.xargs(l) 

at: execute commands at a later time. ..at(l) 

env. set environment for command execution.cnv(l) 

sleep: suspend execution for an interval. .sleep(l) 

sleep: suspend execution for interval.aleep(3C) 

monitor: prepare execution profile.monitor(3C) 

profil: execution time profile. ..profil(2) 

uux: Unix to unix command execution.uux(lC) 

file, execl, exeev, execle, exeeve, execlp, exeevp: execute a . . . exec(2) 

execl, exeev, execle, exeeve, execlp, exeevp: execute a file.exec(2) 

execl, exeev, execle. exeeve, execlp, exeevp: execute a file.exec(2) 

link, unlink: exercise link and unlink system calls.link(6) 

creat: create a new file or rewrite an existing one.creat(2) 

exit, —exit: terminate process.exit(2) 

exit, —exit: terminate process.exit(2) 

function, exp, dexp, eexp: Fortran exponential intrinsic .... exp(3f) 

power, square root functions, exp. log. loglO, pow, sqrt: exponential^ logarithm, . . exp(3VI) 

expand, unexpand: expand tabs to spaces, and vice versa.expand(l) 

versa, expand, unexpand: expand tabs to spaces, and vice . expand(l) 

expire: remove outdated news articles. . ..expire(8) 

thesaurus for diction, diction, explain: print wordy sentences, interactive .diction(l) 

fioat, sngl, dble, cmplx, dcmplx, ichar, char: explicit Fortran type conversion, /idint, real.ftype(3f) 

rogue: Exploring The Dungeons of Doom.rogue(6) 

frexp, Idexp, modf: split into mantissa and exponent.frezp(3C) 

exp, dexp, cexp: Fortran exponential intrinsic function.exp(3f) 

functions, exp, log, loglO, pow, sqrt: exponential, logarithm, power, square root .exp(3U) 

expr: evaluate arguments as an expression.expr(l) 

regexp: regular expression compile and match routines.regexp(7) 

regemp; regular expression compile.regcmp(l) 
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regex, regcmp: regular 
expr; evaluate argumenta as an 
efl: 

greek; graphics for the 
strings, xstr: 

functions, floor, ceil, fmod, 
factor: 

true, 
checkall; 
abort: generate an lOT 


ecvt, 

fopen, freopen, 
stctrkstskip: special streamer 
col; Alter reverse line 
ferror, 
inquiries, 
subroutines, dbminit, 
system, 
fclose, 
getc, getchar, 
gets, 
grep, egrep, 
umask: set 
basename: strip 
ferror, feof, clearerr, 
acctcom: search and print process accounting 
compact, uncompact, ccat: compress and uncompress 

backup. 

more, page: file perusal 
nl: line numbering 
colcrt: 
col: 

plot: graphics 
tplot; graphics 
refer, lookbib: 

And: 

hyphen: 

look: 

ttyname, isatty: 

lorder. 

spell, spellin, spellout: 
binary. Ale. strmgs: 

tty slot: 

fold: fold long lines for 
dbminit. fetch, store, delete. 

tee: pipe 

explicit Fortran type/ int. iAz. idint. real. 

fp: 

absolute value functions, 
functions, floor, ceil. fmod. fabs: 

rxctrl: 

ot. ox: TU 503/TU 603/TU 703 disk. TU 100-4 
rx : RXOl or RX02 
fclose. Alush: close or 
value functions, floor, ceil, 

device. 

fold: 

vfont: 

vfontinfo: inspect and print out information about 


dmesg: collect system diagnostic messages to 
indent; indent and 
acet: per-process accounting Ale 
ar; archive Qil^rary) file 
format: how to 
dump, ddate: incremental dump 

eqn, neqn, checkeq: 

inode: 

core: 


expre.ssion compile/execute.regex(3X) 

expression.c*Fr(l) 

Extended Fortran Language.efl(l) 

extended TTY-37 type-box.. greek(7) 

extract strings from C programs to implement shared xstr(l) 

f77: Fortran 77 compiler.f77(l) 

fabs; floor, ceiling, remainder, absolute value .... floor(3M) 

factor a number...factor(l) 

factor: factor a number.factor(l) 

false: provide truth values..true(l) 

faster file system checking procedure.checkall(8) 

fault.abort(3C) 

fclose, Alush: close or flush a stream.fclose(3S) 

fcntl; Ale control.fcntl(2) 

fcntl; file control options..fcntl(7) 

fevt: output conversion.ecvt(3C) 

fdopen: open a stream..fopen(3S) 

features, skip flies.stctrl(l) 

feeds.coi(l) 

feof, clearerr, flleno: stream status inquiries.ferror(3S) 

ferror, feof, clearerr, flleno: stream status.ferror(3S) 

fetch, store, delete, flrstkey, nextkey; data base . . . dbiR(3X) 

A: list file names and statistics for a file .A(6) 

Alush: close or flush a stream. .fclose(3S) 

fgetc, getw: get character or word from stream. . . . gctc(3S) 

fgets: get a string from a stream..geta(3S) 

fgrep; search a flic for a pattern.grep(l) 

flle-creation mode mask. . ..umask(l) 

filename aflixes.bQsename(l) 

flleno: stream status inquiries..•. ferror(3S) 

fllc(s).acctcom(l) 

flies, and cat them. .compact(l) 

fllesave, tapesave: daily/weekly UNIX file system . . . fllcsave(8) 

Alter for ert viewing.morc(l) 

Alter.nl(l) 

Alter nroA output for CRT previewing.colcrt(l) 

filter reverse line feeds..col(l) 

filters.plot(lG) 

filters.tplot(lG) 

find and insert literature references in documents. . refcr(l) 

find flics.flnd(l) 

find; And flies.flnd(l) 

find hyphenated words.hyphen(l) 

find lines in a sorted list.. look(l) 

find name of a terminal.ttyname(3C) 

find ordering relation for an object library.lorderfl) 

find spelling errors..spcll(l) 

find the printable strings in a object, or other .... strings(l) 
find the slot in the utmp file of the current user. . . ttyslot(3C) 

finger: user information lookup program. .flnger(l) 

finite width output device.fold(l) 

flrstkey, nextkey: data base subroutines.dbm(3X) 

fitting.tcc(l) 

float, sngl, dble, cmplx, dcmplx, ichar, char:.ftypc(3f) 

Floating Point on the CAOUUS.fp(3) 

floor, ceil, fmod. fabs: floor, ceiling, remainder. . . . floor(3M) 

floor, ceiling, remainder, absolute value.floor(3U) 

floppy disk manipulating program..rxctrl(l) 

floppy disk.ot(4) 

floppy disk.rx(4) 

flush a stream. .fclose(3S) 

fmod, fabs: floor, ceiling, remainder, absolute .... floor(3U) 

fmt; simple text formatter.fmt(l) 

fold: fold long lines for finite width output.fold(l) 

fold long lines for finite width output device.fold(l) 

font formats for the Benson-Varian or Versatec. . . . vfont(5) 

fonts.vfontinfo(l) 

fopen, freopen, fdopen: open a stream..fopen(3S) 

fork: create a new process.fork(2) 

form error log.dmesg(8) 

format a C program source.indent(l) 

format.acct(5) 

format.ar(5) 

format disks.format(8) 

format.dump(5) 

format; how to format disks.format(8) 

format mathematical text for nroA or troA.cqn(l) 

format of an inode.inodc(5) 

format of core image file.core(5) 
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cpio: forrriAt of cpio archive. ..cpio(5) 

dir: format of directories..dir(5) 

a.out: format of programs and modules.ahdr(5) 

a.out: format of programs and modules.a.outfS) 

sccsAle: format of SCCS file.sccsflJe(5) 

fs: file system format of system volume. .fs( 5 ) 

fspec: format specification in text files... fspec(5) 

tbl: format tables for nrofT or trolT.tbi(l) 

trofT, nrofT: typeset or format text.trofT(l) 

vfont: font formats for the Benson-Varian or Versatec.vfont(5) 

intro: introduction to file formats.LntrofS) 

utmp, wtmp: utmp and wtmp entry form.ats.. ! ! ! ! ut.mp(5) 

scanf. fscanf, sscanf: formatted input conversion. ..scanf(3S) 

mm: print out documents formatted with the UU macros.mm(l) 

fmt: simple text formatter.fmt(l) 

printf, fprintf, sprintf: output formatters.printf(3S) 

mptx: the macro package for formattLng a permuted index.mptx(7) 

check: disk checking and formatting.. check(8) 

mm: the UU macro package for formatting documents.mm(7) 

mosd: the OSDO adapter macro package for formatting documents.mosd(7) 

man: macros for formatting entries in this manual.man(7) 

ms: macros for formatting manuscripts.ms(7) 

me: macros for formatting papers. .me(7) 

f77: Fortran 77 compiler.f77(l) 

abs, iabs, dabs, cabs, zabs: Fortran absolute value.abs(3f) 

signal: specify Fortran action on receipt of a system signal.signal(3f) 

acos, dacos: Fortran arccosine intrinsic function.acos(3f) 

asin, dasin: Fortran arcsine intrinsic function.asin(3f) 

atan2, datan2: Fortran arctangent intrinsic function.atan2(3f) 

atan, datan: Fortran arctangent intrinsic function.atan(3f) 

and. or, xor, not, Ishift, rshift: Fortran bitwise boolean functions.. bool(3f) 

getarg: return Fortran command-line argument. . .'.getarg(3f) 

log 10, alog 10, dlog 10: Fortran common logarithm intrinsic function.log 10(3f) 

conjg, dconjg: Fortran complex conjugate intrinsic function.conjg(3f) 

cos, dcos, ccos: Fortran cosine intrinsic function.cos(3f) 

ratfor. rational Fortran dialect.ratfor(l) 

getenv: return Fortran environment variable.getenv(3f) 

exp, dexp, cexp: Fortran exponential intrinsic function.cxp(3f) 

cosh, dcosh: Fortran hyperbolic cosine intrinsic function.cosh(3f) 

sinh, dsinh: Fortran hyperbolic sine intrinsic function.sinh(3f) 

tanh, dtanh: Fortran hyperbolic tangent intrinsic function.tanh(3f) 

aimag, dimag: Fortran imaginary part of complex argument.ai.TLag(3f) 

aint, dint: Fortran integer part intrinsic function. . ..aint(3f) 

efl: Extended Fortran Language.cfl(l) 

max, maxO, amaxO, maxi, amaxl. dmaxl: Fortran maximum-value functions.max(3f) 

min, minO, aminO, mini, aminl, dminl: Fortran minimum-value functions..min(3f) 

log, alog, dlog, clog: Fortran natural logarithm intrinsic function.log(3f) 

anint, dnint, nint, idnint: Fortran nearest integer functions.round(3f) 

abort: terminate Fortran program.abort(3f) 

struct: structure Fortran programs.struct(l) 

mod, amod, dmod: Fortran remaindering intrinsic functions. .mod(3f) 

sin, dsin, csin: Fortran sine intrinsic function...ain(3f) 

sqrt, dsqrt, csqrt: Fortran square root intrinsic function.sqrt(3f) 

len: return length of Fortran string.len(3f) 

index: return location of Fortran substring.index(3f) 

system: issue a shell command from Fortran.... . systcm(3f) 

tan, dtan: Fortran tangent intrinsic function.tan(3f) 

mclock: return Fortran time accounting.mclock(3f) 

sign, isign, dsign: Fortran transfer^of-sign intrinsic ftinction.aign(3f) 

sngl, dble, cmplx, dcmplx, ichar, char: explicit Fortran type conversion, /iflx, idint, real, float, . . . ftype(3f) 

rand, srand: Fortran uniform random-number generator.rand(3f) 

fp: Floating Point on the CADUUS.fp(3) 

printf, fprintf, sprintf: output formatters.printf(3S) 

putc, putchar, fputc, putw: put character or word on a stream. . . . putc(3S) 

puts, fputs: put a string on a stream.puts(3S) 

C stack frame layout.stack(5) 

fread, fwrite: buffered binary input/output.fread(3S) 

df: report number of free disk blocks.. . df(l) 

df: report number of free disk blocks.df(0) 

malloc, free, realloc, calloc: main memory allocator.malloc(3C) 

fopen, freopen, fdopen: open a stream .fopcn(3S) 

hertz: get the line frequency on the current machine.. . hcrt 2 ( 2 ) 

exponent, frexp, Idexp, modf: split into mantissa and.frexp(3C) 

colrm remove columns from a file.colrm(l) 

gets, fgets: get a string from a stream .. gets(3S) 

rmdel: remove a delta from an SCCS flle.rmdel(l) 

getopt: get option letter from argv.gctopt(3C) 

xstr: extract strings from C programs to implement shared strings. .... xstr(l) 

read: read from flle... read(2) 
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system: issue a shell command 
from: who is my mail 
ncheck: generate names 
nlist: get entries 
soelim: eliminate .so‘s 
acctcms: command summary 
getc, getchar, fgetc, getw: get character or word 

getpw: get name 


scan/, 

checklist: list of file systems processed by 
interactive repair. 


stat, 

fseek. 


chfn: change 
erf, erfc; error 
structure, 
fread, 
records, 
backgammon: the 
startrek: THE 
moo: guessing 
back: the 
bj: the 
craps: the 
reversi: reversi, a 
wump: the 
intro; introduction to 
gamma: log 

send: 

abort: 

newconf: 

makekey: 

ctermid: 

ncheck: 

/mrand48. jrand48, srand48. seed48. lcong48: 

lei: 

rand, arand: random number 
rand, srand: Fortran uniform random-number 

gets, fgets: 
get: 
ulimit: 

getc, getchar, fgetc, getw: 

nlist: 

umask: set and 
stat, fstat: 
ustat: 


getgrent, getgrgid, getgmam, setgrent. endgrent: 

getlogin: 

logname: 

getpw. 

system, unamc, cthname; 
unget: undo a previous 
getopt: 

getpwent, getpwuid, getpwnam, setpwent, cndpwent: 

getcwd: 

times: 

getpid. getpgrp, getppid: 
elTective group/ getuid, geteuid, getgid. getegid: 

tty: 

hertz: 

time; 

from stream, 
stream, getc, 

and efTective group IDs. getuid. geteuid. getgid. 


user, real group, and efTective group IDs. getuid, 
real group, and efTective group/ getuid. geteuid. 


from Fortran.system(3f) 

from?.f.-omll) 

from i-numbers.ncheck(8) 

from name list.. • • nlist(3C) 

from nrofT input.soeiim( 1) 

from per-process accounting records.acctcma(8) 

from stream.getc(3S) 

fromUID.getpw(3C) 

from: who is my mail from?..from(l) 

fs: file system format of syste.m volume.fs(5) 

fsba: file system block analyzer.fsba(0) 

fscanT, sscanf: formatted input conversion.scanf(3S) 

fsck.c.hecklist(5) 

fsck, dfsck: file system consistency check and .... fsck(8) 

fsdb: file system debugger.f3db(0) 

fseek. fteU, rewind: reposition a stream..fseek(3S) 

fspec: format specification in text files.fspec(5) 

fstat: get file status.stat(2) 

ftell, rewind; reposition a stream. .fseek(3S) 

ftw: walk a file tree.ftw(3C) 

full name of user.chfn(l) 

function and complementai^ error function.crf(3M) 

fuser: identify processes using a file or file.fuser(0) 

fwrite: buffered binary input/output.fread(3S) 

fwtmp, wtmpfli: manipulate connect accounting . . . fwtmp(0) 

game.backgammon(6) 

game based on the t.v. series.startrek(6) 

game.moo(6) 

game of backgammon.back(6) 

game of black jack...bj(6) 

game of craps...craps(6) 

game of dramatic reversals. .revcrsi(0) 

game of hunt-the-wumpus.wump(6) 

games.intro(6) 

gamma function.ga.mma(3M) 

gamma: log gamma function.gamma(3M) 

gather files and submit RJE jobs.send(lC) 

generate an lOT fault.abort(3C) 

generate configuration file and reconfigure UUNDC. . newconf(0) 

generate encryption key.makekey(0) 

generate file name for terminal. . . • ..ctermid(3S) 

generate names from i-numbers.ncheck(0) 

generate uniformly distributed pseudo-random/ . . drand40(3C) 

generator of lexical analysis programs. .lex(l) 

generator.. rand(3C) 

generator.rand(3f) 

get a string from a stream..gets(3S) 

get a version of an sees file. .get(l) 

get and set user limits.ulimit(2) 

get character or word from stream. .getc(3S) 

get entries from name list.nlist(3e) 

get file creation mask.umask(2) 

get flle status.stat(2) 

get flle system statistics.. ustat(2) 

get: get a version of an SeeS file.gct.(l) 

get group flle entry. getgrent(3e) 

get login name.getlogin(3C) 

get login name.logname(l) 

get name from UID.getpw(3C) 

get nome/cthernet-identifleation of current UNIX . . uname(2) 

get of an sees file.ungct(lj 

get option letter from argv.getopt(3e) 

get password flle entry.getpwent(3e) 

get path-name of current working directory.getcwd(3C) 

get process and child process times.times(2) 

get process, process group, and parent process IDs. . getpid(2) 

get real user, effective user, real group, and.getuid(2) 

get terminal name.Uy(l) 

get the line frequency on the current machine. . . . hertz(2) 

get time.time(2) 

getarg: return Fortran command-line argument. . . getarg(3f) 
getc, getchar. fgetc. getw: get character or word . . getc(3S) 
getchar. fgetc. getw: get character or word from . . getc(3S) 
getcwd: get path-name of current working directory. getcwd(3C) 
getegid: get real user, effective user, real group. . . . getuid(2) 

getenv: return Fortran environment variable.getenv(3f) 

getenv: value for environment name.getenv(3C) 

geteuid, getgid, getegid: get real user, effective . . . getuid(2) 
getgid, getegid: get real user, effective user,.getuid(2) 
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Permuted Index 


get group flle entry, 
file entry, getgrent, 
getgrent, gctgrgid, 


parent process IDs. getpid, 
group, and parent process IDs. 
process IDs. getpid. getpgrp. 

get password flle entry, 
entry, getpwent, getpwuid, 
password flle entry, getpwent, 

discipline. 

gettydefs: speed and terminal settings used by 

eflective user, real group, and effective group/ 
endutent, utmpname: access utmp flle entry, 
utmpname; access utmp flle entry, getutent, 
access ut.mp flJe entry, getutent, getutid, 
getc, getchar, fgetc, 
ASCII, ctime, localtime, 
setjmp, longjmp: non-local 

graph: draw a 
sag: system activity 
plot: 
tplot: 
greek: 
plot: 
plot: 

mmt, mvt: typeset documents, view 
mv: a macro package for making view 


getegid: get real user, effective user, real 
getpid. getpgrp, getppid: get process, process 
chown, chgrp: change owner or 
getgrgid, getgmam, setgrent. endgrent: get 

group: 

/etc/pwmap, /etc/groupmap: user and 
setpgrp: set process 
id: print user and 
user, effective user, real group, and effective 
setuid, setgid: set user and 
newgrp: log in to a new 
chown: change owner and 
kill: send a signal to a process or a 
make; maintain, update, and regenerate 

pwck, 

ssignal, 

hangman; 

moo: 

terminals, hp: 

hsearch, hcreate, hdestroy: manage 
hsearch, 
hsearch. hcreate. 

help: ask for 
machine, 
zd : 

hier: flle system 
rl, 

hp: handle special functions of 
2621-series terminals. 

tables . 
wump: the game of 
cosh, dcosh: Fortran 
adnh, cosh, tanh; 
sinh, dsanh: Fortran 
tanh. dtanh: Fortran 


getgrent. getgrgid. getgrnam. setgrent, endgrent: . . getgrent(3C) 
getgrgid. getgrnam, setgrent, endgrent: get group . . getgrent(3C) 
getgrnam, setgrent. endgrent: get group file entry. . gctgrent(3C) 

getlogln: get login name. .getiogin(3C) 

getopt: get option letter from argv.. getopt(3C) 

getopt: parse co.mmand options.. getopt(l) 

getpass: read a password.getpass(3C) 

getpgrp, getppid: get process, process group, and . . getpid(2) 
getpid, getpgrp. getppid; get process, process .... getpid(2) 
getppid: get process, process group, and parent . . . getpid(2) 

getpw: get name from UID.getpw(3C) 

getpwent, getpwuid, getpwnam, setpwent, endpwent; getpwent(3C) 
getpwnam. setpwent. endpwent: get password flic . . getpwcnt(3C) 
getpwuid. getpwnam. setpwent, endpwent; get .... getpwent(3C) 

gets, fgets; get a string from a stream..gets(3S) 

getty : set terminal type, modes, speed, and line . . . getty(8) 

. gettydcfs(5) 

gettydefs: speed and terminal settings used by ... gettydef 3 ( 5 ) 

getuid, geteuid, getgid, getegid: get real user.getuid(2) 

getutent. getutid, getutline, pututline, setutent, . . . getut(3C) 
getutid. getutline, pututline. setutent, endutent, . . getut(3C) 
getutline, pututline, setutent. endutent, utmpname. getut(3C) 

getw: get character or word from stream. .getc(3S) 

gmtime, asetime, tzset: convert date and time to . . ctimc(3C) 

goto .setjmp(3C) 

graph; draw a graph.graph(lG) 

graph.graph(lG) 

• ..«8(1G) 

graphics Alters.plot(lG) 

graphics Alters.tpiot(lG) 

graphics for the extended TTY-37 type-box..greek(7) 

graphics interface.piot(5) 

graphics interface subroutines. ... plot(3X) 

graphs, and slides.mmt(l) 

graphs. .rnv(7) 

greek: graphics for the extended TTY-37 type-box. . grcck(7) 

grep, egrep, fgrep: search a flle for a pattern.grcp(l) 

group, and effective group IDs. /geteuid, getgid. . . . getuid(2) 

group, and parent process IDs. .getpid(2) 

group..chown(l) 

group flle entry, getgrent. .getgrcnt(3C) 

group flle.grou?(5) 

group: group flle.group(5) 

group id mappings for the Newcastle Connection. . . pwmap(5N) 

group ID.setpgrp(2) 

group IDs and names..id(l) 

group IDs. /geteuid, getgid, getegid: get real.gctuid(2) 

group IDs..setuid(2) 

group.ncwgrp(l) 

group of a file.chown(2) 

group of processes.. . kill(2) 

groups of programs..makc(l) 

grpek: password/group flic checkers.pwck(8) 

gsignal: software signals.ssignal(3C) 

guess the word.hangman(6) 

guessing game.moo(6) 

handle special functions of HP 2640 and 2621-series hp(l) 

hangman: guess the word. hangman(6) 

hash search tables.hsearch(3C) 

hcreate, hdestroy; manage hash search tables .... hscarch(3C) 

hdestroy: manage hash search tables.hsearch(3C) 

help: ask for help... help(l) 

help.help(l) 

hertz: get the line frequency on the current.hcrtz(2) 

hexadecimal dump.id(l) 

hier: flic system hierarchy.hier(7) 

hierarchy.. hicr(7) 

hk: RK611/RKOe, RK07 moving-head disk.hk(4) 

hi: RLOl/RL02 moving-head disk.rl(4) 

HP 2640 and 2621-series terminals.hp(l) 

hp; handle special functions of HP 2640 and.hp(l) 

hp: RP04/05/06, Rlii(02/03 moving-head disk.hp(4) 

hsearch, hcreate, hdestroy: manage hash search . . hscarch(3C) 

hunt-the-wumpus..wump(6) 

hyperbolic cosi.ne intrinsic function.cosh(3f) 

hyperbolic functions..ainh(3M) 

hyperbolic sine intrinsic function.sinh(3f) 

hyperbolic tangent intrinsic function.. tanh(3f) 

hyphen: And hyphenated words.hyphcn(l) 
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Permuted Index 


hyphen: find 
abs« 

rjc: RJE (Remote Job Entry) to 
/idint, real, float, sngl, dble, cmpLi. dcmplx, 
/etc/pwmap, /etc/groupmap: user and group 
/etc/setugi; alter user 

setpgrp: set process group 
issue: issue 
fuser: 
what: 

ichar, char: explicit Fortran type/ int, iflx, 
anint, dnint, nint, 
id: print user and group 
get process, process group, and parent process 
effective user, real group, and effective group 
setuid, setgid: set user and group 
dcmplx, ichar, char: explicit Fortran type/ int, 

core: format of core 
aimag, dimag: Fortran 
xstr: extract strings from C programs to 
which: locate a program file 
dump, ddate: 
dump: 
restor. 
indent: 

tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal 
mptx: the macro package for formatting a permuted 

ptx: permuted 


inittab: script for the 

process. /etc/KCsctup: 
init, telinit: process control 
bre, bcheckrc, rc, powerfail: system 
/etc/usam: 
popen, pclose: 

clri: clear 

inode: format of an 
scanf, fscanf, sscanf: formatted 
soelim: eliminate .so's from nroff 
ungetc: push character back into 
fread, fwrite: buffered binary 
stdio: standard buffered 
ferror, feof, clearerr, fileno: stream status 
uustat: UUCP status 
refer, lookbib: find and 
vfontinfo: 
install: 

uucp: UUCP 

mail.nc: mail(l) using the Newcastle Connection 
learn: computer aided 
dcmplx, ichar, char: explicit Fortran type/ 

abs: 

anint, dnint, nint. idnint: Fortran nearest 
aint, dint: Fortran 
13tol, ltol3: convert between 3-byte 
ltol3: convert between 3-byte integers and long 

bcopy: 

fsck, dfsek: file system consistency check and 
rjestat: RJE status report and 
diction, explain: print wordy sentences. 

bbp: Basic Block Port 
kl: KL-11 or DL-11 asynchronous 
Ibp: LBP-10 Laser Beam Printer 
plot: graphics 
sbp: Simplified Basic Block Port 
St: SCTll Streamer 
plot: graphics 
termio: general terminal 
tm,ts; TM-ll/TU-lO magtape interface, TS-11 magtape 


hyphenated words. 

hypot: Euclidean distance function. 

iabs, dabs, cabs, xabs: Fortran absolute value, 
large: Number of command-line arguments. . 

IBM. 

ichar, char; explicit Fortran type conversion, 
id mappLngs for the Newcastle Connection. . . 

id of a UNDC server. 

id: print user and group IDs and names. . . . 

ID. 

identification file. 

identify processes using a file or file structure. 

identify SCCS flies. 

idint. real, float, sngl, dble. cmplx, dcmplx. . . 
idnint; Fortran nearest integer functions. . . 

IDs and names. 

IDs. getpid, getpgrp, getppid:. 

IDs. /geteuid, getgid, getegid: get real user, . 

IDs. 

iflx, idint. real, float, sngl, dble. cmplx. 

ifprolog: The prolog interpreter system. . . . 

image file. 

imaginary part of complex argument. 

implement shared strings. 

including aliases and paths (esh only). 

incremental dump format. 

incremental file system dump. 

incremental file system restore. 

indent and format a C program source. . . . 
indent: indent and format a C program source, 
independent operation routines, tgetent, . . 

index. 

index. 

index: return location of Fortran substring. . 

inews: submit news articles. 

init process.. 

init, telinit: process control initialization. . . 
initialise the Newcastle Connection tables in a 

initialization. 

initialization shell scripts.. 

initiate a UNIX server for a remote client. . . 

initiate I/O to/from a process. 

inittab: script for the init process. 

i-node. 

inode: format of an inode. 

inode.. 

input conversion. 

input. .. 

input stream. . 

input/output. 

input/output package. 

inquiries. . 

inquiry and job control. 

insert literature references in documents. . . 
inspect and print out information about fonts. 

install comjnands. 

install: install commands. 

installation made easy. 

instead of uucp. 

instruction about UNIX.. . 

int, iflx, idint, real, float, sngl. dble. cmplx, . . 

integer absolute value. 

integer functions. 

integer part intrinsic function. 

integers and long integers. 

integers. 13tol. 

interactive block copy. 

interactive repair. 

interactive status console. 

interactive thesaurus for diction. 

Interface.. 

interface.. 

Interface. 

interface. 

Interface... 

interface. 

interface subroutines. 

interface. 

interface. 


hyphen(l) 

hypot(3if) 

abs(3f) 

iargc(3f) 


. . . pwmap(5N) 

. . . 8etugi(6N) 

. . . id(l) 

. . . setpgrpC2) 

. . . issue (5) 

. . fuser(8) 

. . . what(l) 

. . . ftype(3f) 

. . . round(3f) 

. . . id(l) 

. getpid(2) 

. getuid(2) 

. . . setuid(2) 

. . . ftype(3f) 

. . . ifprolog(l) 

. . . core(5) 

. . . aimag (3f) 

. . . xstr(l) 

. . . which(l) 

. . . dump(5) 

. . . dump(8) 

. . . restor(8) 

. . . indent(l) 

. . . indent(l) 

. . . termcap(3) 

. . . mptx(7) 

. • • p«(») , 

. . . index(3f) 

. . . inews(l) 

. ^ . inittAb(5) 

. . . init(8) 

. . . NCsetup(8N) 
. . . mit(8) 

. . . brc(8) 

. . . usam(8N) 

. . . popen(3S) 

. . . inittab(S) 

. . . clri(8) 

. ■ . inode(5) 

. . . inode(5) 

. . . scanf(3S) 

. . . soelim(l) 

. . . ungetc(3S) 

. . . fread(3S) 

. . . stdio(3S) 

. . . ferror(3S) 

. . . uustat(lC) 

. . . refer(l) 

. . . vfontinfo(l) 
. . . install(8) 

. . . install(6) 

. . . uucp(8) 

. . . mail(110 

. . . leam(l) 

. . . ftype(3f) 

, . . abs(3C) 

. . . round(3f) 

. . . aint(3f) 

. . . 13tol(3C) 

. . . 13tol(3C) 

. . . bcopy(8) 

. . . fsck(8) 

. . . rjestat(lC) 

. . . diction(l) 

. . . bbp(4) 

. . . kl(4) 

. . . lbp(4) 

. . . plot(5) 

• . 3bp(4) 

. . . 5t(4) 

. . . plot(3X) 

. . . termio(4) 

. . . tm(4) 
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Permuted Index 


nfcommcnt: a user 
tm.ts: TM-11 /TU-10 magtape 
tty; controUmg terminal 
spline: 
basic; Basic 
pti; phototypesetter 
sno; SN030L 
ifprolog; The prolog 
csh: a shell (command 
pipe; create an 
configuration information; table of 
sleep: suspend execution for an 
sleep; suspend execution for 


numbers, 
procedures, 
ncheck: generate names from 
popen, pclose; initiate 

abort: generate an 
isalpha, isupper, islower, isdigit, isxdigit, 
isalnum, is^ace, ispunct. isprint, isgraph,/ 
isspace, ispunct, isprint, isgraph, iscntrl, 

ttyname, 

isalnum, isspace, ispunct, isprint, isgraph, 
isprint, isgraph,/ isalpha, isupper, islower, 
/isxdigit, isalnum, isspace, ispunct, isprint, 
function, sign, 
ispunct, isprint, isgraph,/ isalpha, isupper, 
/isdigit, isxdigit, isalnum, isspace, ispunct, 
/islower, isdigit, isxdigit, isalnum, isspace, 
/isupper, islower, isdigit, isxdigit, isalnum, 

system: 

system; 

issue: 

isspace, ispunct, isprint, isgraph,/ isalpha, 
isgraph,/ isalpha, isupper, islower, isdigit, 
news: print news 

* 

jO. 

bj; the game of black 
jO.jl. 

drand48, erand46, lrand46, nrand48, mrand48, 
msgs: system messages and 
whatconf: what device drivers are in an unix 
makekey: generate encryption 
keycap: 

apropos; locate commands by 
killall: 

processes. 


kl: 

mem, 
quiz: test your 

Is, 11, 

long integers. 

a64l. 

volcopy, labelit: copy file systems with 

volcopy, 

awk: pattern scanning and processing 
be: arbitrary-precision arithmetic 
efl: Extended Fortran 
epp:the C 

shell, the standard/restricted command programming 

Ibp: LBP-10 

prtacct, runacct,/ charge fee, ckpacct, dodisk, 

C stack frame 

Itroff, vtrofT: trofi to the CANON 


interface to the notesflle system.nfcomment(3) 

interface, TS-11 magtape interface.tm(4) 

interface.. tt 7 ( 4 ) 

interpolate smooth curve. .spline(lC) 

Interpreter.basic(l) 

interpreter.pti(l) 

interpreter.sno(l) 

interpreter system.. . ifproiog(l) 

interpreter) with C-like syntax.. csh(l) 

interprocess channel.pipe(2) 

intermpt vector and device addresses.conftnfo(4) 

interval.sleep(l) 

interval.aleep(3C) 

intro: introduction to commands.intro(l) 

intro: introduction to file formats.intro(5) 

intro: introduction to games. .intro(6) 

intro; introduction to miscellany.intro(7) 

intro: introduction to special files.intro(4) 

intro: introduction to subroutines and libraries. . . . intro(3) 

intro: introduction to system calls and error .... intro(2) 

intro: introduction to system maintenance .intro(a) 

i-numbers..ncheck(8) 

I/O to/from a process.popen(3S) 

ioctl: control device.ioctl(2) 

[OT fault.abort(3C) 

isalnum, isspace, ispunct, isprint, isgraph,/ .ctype(3C) 

isalpha, isupper, islower, isdigit, isxdigit.ctype(3C) 

isascii: classify characters, /isxdigit, isalnum, .... ctypc(3C) 

isatty: find name of a terminal.ttyname(3C) 

iscntrl, isascii: classify characters, /isxdigit.ctype(3C) 

isdigit, isxdigit, isalnum, isspace, ispunct, .ctype(3C) 

isgraph, iscntrl, isascii: classify characters.ctype(3C) 

isign, dsign: Fortran transfer-of-sign intrinsic .... sign(30 

islower, isdigit, isxdigit, isalnum. isspace, .ctype(3C) 

isprint, isgraph. iscntrl, isascii: classify/.ctype(3C) 

ispunct, isprint, i^raph, iscntrl, isascii:/ ...... ctypc(3C) 

isspace, ispunct, isprint, isgraph, iscntrl,/.ctypc(3C) 

issue a shell command.system(3S) 

issue a shell command from Fortran.. . system(3f) 

issue identification file.issue(5) 

issue: issue identification file.issue(5) 

isupper, islower, isdigit, isxdigit, isalnum, .ctype(3C) 

isxdigit, isalnum, isspace. ispunct. isprint.ctype(3C) 

items.news(l) 

jO. jl, jn, yO. yl. yn: Bessel functions.bessel(3U) 

jl, jn, yO, yl. yn: Bessel functions. .bes3el(3M) 

jack.bj(0) 

jn. yO, yl. yn: Bessel functions..bessel(3l0 

join: relational database operator.join(l) 

jrand48. arand48. seed48. lcong48: generate/ .... drand46(3C) 

junk mail program. .m 3 gs(l) 

kernel.whatconf(8) 

key.makekey(8) 

keyboard capability data base.keycap(5) 

keycap: keyboard capability data base.keycap(5) 

keyword lookup.apropos(l) 

kill all active processes.kiDaii(8) 

kill: send a signal to a process or a group of.kiU(2) 

kiU; terminate a process.kill(l) 

killall: kill all active processes.kiUall(8) 

kl; KL-11 or DLrll asynchronous interface.kl(4) 

Klrll orDL-11 asynchronous interface.kl(4) 

kmem: core memory.• • • menri(4) 

knowledge.. quiz(6) 

1. Ir. If, lx: list contents of directory.ls(l) 

13tol, ltol3: convert between 3-byte integers and . . . 13tol(3C) 

164a: convert between long and base-64 ASCII.a64l(3C) 

label checking. ..volcopy(8) 

labelit: copy file systems with label checking.volcopy(8) 

language..awk(l) 

language. ...bc(l) 

Language.«fi(l) 

language preprocessor.cpp(l) 

language, sh, rsh:.ah(l) 

Laser Beam Printer Interface.lbp(4) 

lastlogin, monacct, nuUadm, pretmp, prdaily.acctsh(6) 

layout.stack(5) 

Ibp: LBP-10 Laser Beam Printer Interface.lbp(4) 

LBP or the Versatec V80..Itroff(l) 
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Ibp: 

cc, 

iirand46, mrand48. jrand48. srand46. aeed48. 

frexp, 

leave: remind you when you have to 


len: return 
getopt: get option 

lex: generator of 
Is. 11. 1. Ir. 

intro: introduction to subroutines and 
ranlib: convert archives to random 
ar: archive 

lorder: And ordering relation for an object 
ar: archive and 
ulimit: get and set user 
getty : set terminal type, modes, speed, and 
col: filter reverse 
hertz: get the 
line: read one 
nl: 

cut: cut out selected fields of each 

Ipd: 

Ip : parallel 
Ipctrl: set options on the parallel 
Ipr. 

Isearch: 
head: give first few 
link, unlink: exercise 

cp. In, mv: copy, 
link: 
calls. 


Is. 11.1. Ir. If. lx: 

fl: 

look: find lines in a sorted 
nlist: get entries from name 
nm: print name 
checklist: 
users: compact 
cref: make cross-reference 
xref : cross-reference 
xargs: construct argument 
refer, lookbib: find and insert 
Is, 
cp. 
Id: 

time to ASCII, ctime, 
(csh only), which: 

apropos: 
whereis: 
index: return 
end, etext, edata: last 
plock: 


intrinsic function. 
coUect system diagnostic messages to form error 

gamma: 

newgrp: 

power, square root functions, exp, 
intrinsic function, 
square root functions, exp, log, 
loglO, aloglO, dloglO: Fortran common 
log. alog, dlog, clog: Fortran natural 
exp, log, log 10. pow, sqrt: exponential, 
getlogin: get 
logname: get 
cuserid: character 
logname: 
passwd: change 


profile: setting up an environment at 


LBP-10 Laser Beam Printer Interface.lbp(4) 

Icc: C compiler.cc(l) 

lcong48: generate uniformly distributed/ /Irand48, . drand48(3C) 

Id: loader..ld(l) 

Idexp, modf: split into mantissa and exponent. . . . frexp(3C) 
learn: computer aided instruction about UNDC . . . leam(l) 

leave.lcQve(l) 

leave: remind you when you have to leave.leave(l) 

len: return length of Fortran string.len(3f) 

length of Fortran string.len(3f) 

letter from argv.getopt(3C) 

lex: generator of lexical analysis programs.lex(l) 

lexical analysis programs.lex(l) 

If, lx: list contents of directory.ls(l) 

libraries.mtro(3) 

libraries.ranlib(l) 

(library) file format..ar(5) 

library.lorder(l) 

library maintainer.ar( 1) 

limits.ulimit(2) 

line discipline.getty(8) 

linefeeds.col(l) 

line frequency on the current machine.hert 2 ( 2 ) 

line.line(l) 

line numbering filter.nl(l) 

line of a file.cut(l) 

line printer dae.mon.lpd(8) 

line printer.ip(4) 

line printer.Ipctrl(l) 

line printer spooler.Ipr(l) 

line: read one line.line(l) 

linear search and update.lsearch(3C) 

lines.head(l) 

link and \inlink system calls.link(8) 

link: link to a file.link(2) 

link or move files..cp(l) 

link to a file.link(2) 

link, unlink: exercise link and unlink system.link(8) 

lint: a C program verifier.lint(l) 

list contents of directory.ls( 1) 

list file names and statistics for a file system. .... fi(8) 

list... look(l) 

list.niist(3C) 

list.nm(l) 

list of file systems processed by fsck.checklist(5) 

list of users who are on the system. .users(l) 

listing.cref(l) 

listing.xref(l) 

list(s) and execute command.xargs(l) 

literature references in documents.refer(l) 

11.1, Ir, If. lx: list contents of directory..ls(l) 

In, mv: copy, link or move files..cp(l) 

loader..ld(l) 

localtime, gmtime, asetime, tzset: convert date and . ctime(3C) 
locate a program file including aliases and paths . . which(]) 

locate commands by keyword lookup.apropos(l) 

locate source, binary, and or manual for program. . whereis(l) 

location of Fortran substring.. index(3f) 

locations in program..end(3C) 

lock process, text, or data in memory. .plock(2) 

lock: reserve a terminal.lock(l) 

log. alog, dlog, clog: Fortran natural logarithm . . . log(3f) 

log. dmesg: .dmesg(8) 

log gamma function.gamma(3U) 

log in to a new group.ncwgrp(l) 

log, loglO, pow, sqrt: exponential, logarithm.exp(3M) 

loglO, aloglO. dloglO: Fortran common logarithm . . Iogl0(3f) 
loglO, pow, sqrt: exponential, logarithm, power, . . . exp(3U) 

logarithm intrinsic function.Iog10(3f) 

logarithm intrinsic function.log(3f) 

logarithm, power, square root functions.exp(3M) 

logLn name.getlogin(3C) 

login name.lognome(l) 

login name of the user.•.cuserid(3S) 

login name of user.logname(3X) 

login password.passwd(l) 

login: sign on.login(l) 

login time.profilc(5) 

logname: get login name.logname(l) 
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Permuted Index 


logname: login name of user.logname(3X) 

aetjmp, longjmp: non-local goto.setjmp(3C) 

documenL’i. refer, lookbib: find and insert literature references in . . . refer(l) 

apropos: locate commands by keyword lookup.apropos(l) 

finger: user information lookup program.finger(l) 

library, lorder: And ordering relation for an object.lorder(l) 

nice, nohup: run a command at low priority.nicc(l) 

Ip : parallel line printer.lp(4) 

Ipctrl: act options on the parallel line printer.Ipctrl(l) 

Ipd: line printer daemon.lp<i(6) 

Ipr: line printer spooler.Ipr(l) 

la, 11. 1. Ir. If. Iz: list contents of directory..ls(l) 

seed46. Icong46: generate/ drand46, erand40, lrand46. nrand48. mrand48. jrand46. arand46, .... <irand46(3C) 

la. 11,1, Ir, If, lx: list contents of directory.la(l) 

Isearch: linear search and update.lscarch(3C) 

Iseek: move read/write flie pointer.lscek(2) 

and, or, xor, not, Ishift, rshift: Fortran bitwise boolean functions. . . . bool(3f) 

integers. 13tol, ltol3; convert between 3-bytc integers and long . . . 13tol(3C) 

Versatec V80. ItrofT, vtrolT: troll to the CANON LBP or the.ItrofT(l) 

Is, 11,1, Ir. If, lx: list contents of directory.ls(l) 

m4: macro processor.m4(l) 

hertz: get the line frequency on the current machine.hert2(2) 

mptx: the macro package for formatting a permuted index. . . mptx(7) 

mm: the UU macro package for formatting documents.mm(7) 

.mosd: the OSDD adapter macro package for formatting documents.mosd(7) 

mv: a macro package for making view graphs.mv(7) 

m4; macro processor..m4(l) 

mm: print out documents formatted with the UU macros.mm(l) 

mt: magnetic tape manipulating program..rxtt(l) 

tni.tj: TU-11 /TU-10 magtape interface, TS-11 magtape interface.tm(4) 

tm.ts: TU-11/TU-lO magtape interface, TS-11 magtape interface.tm(4) 

from: who is my mail from?.fromO) 

prmail: print out mail in the post office.^ . . prmail(l) 

mail, rmail: send mail to users or read mail..maii(l) 

msgs: system messages and junk mail program..msgs(l) 

recnews; receive unprocessed articles via mail.recnews(l) 

recnews: receive unprocessed articles via mail.recnews(8) 

mail, rmail: send mail to users or read mail.mail(l) 

sendnews: send news articles via mail.sendnews(8) 

mail, rmail: send mail to users or read mail.mail(l) 

uurec: receive processed news articles via mail.uurec(8) 

uuep.. mail.nc: mail(l) using the Newcastle Connection instead of . . mai2(lN) 

instead of uuep.. mail.nc: mail(l) using the Newcastle Connection . . . mail(lN) 

malloc, free, realloc, caUoc: main memory allocator.mallac(3C) 

programs, make: maintain, update, and^regenerate groups of.make(l) 

ar: archive and library maintainer.*.ar(l) 

intro: introduction to system maintenance procedures.intro(8) 

delta: make a delta (change) to an SCCS Ale.delta(l)^ 

mkdir : make a directory.mkdir(l) 

mknod: make a directory, or a special or ordinary Ale.mknod(2) 

/etc/mksys: make a remote system node.mkays(8N) 

mktemp: make a unique Ale name.mktemp(3C) 

cref: make cross-reference listing.cref(l) 

banner: make long posters.banner(6) 

programs, make: maintain, update, and regenerate groups of . make(l) 

script; make typescript of terminal session.script(l) 

makekey: generate encryption key.makekey(0) 

allocator, malloc, free, realloc, calloc: main memory.malloc(3C) 

man: macros for formatting entries in this manual. . man(7) 

man, man prog: print entries in this manual.man(l) 

man: print sections of this manual.man(lb) 

tsearch, tdelete, twalk: manage binary search trees. .tsearch(3C) 

hsearch, hcreate, hdestroy: manage hash search tables.hsearch(3C) 

fwtmp, wtmpAz: manipulate connect accounting records.fwtmp(8) 

mt: magnetic tape manipulating program..mt(l) 

rxctrl: Aoppy disk manipulating program... . rxctrl(l) 

man, manprog: print entries in this manual.man(l) 

frexp, Idexp, modf: split into mantissa and exponent.frexp(3C) 

catman: create the cat Ales for the manual.calmjan(8) 

whereis: locate source, binary, and or manual for program. .whereis(l) 

man, manprog: print entries in this manual.man(l) 

man: print sections of this manual.man(lb) 

man: macros for formatting entries in this manual...man(7) 

ms: macros for formatting manuscripts.ms(7) 

ascii: map of ASCII character set.ascii(7) 

/ctc/pwmap, /etc/groupmap: user and group id mappings for the Newcastle Connection.pwmap(5N) 

umask: set Ale-creation mode mask.umask(l) 

umask: set and get Ale creation mask.umaak(2) 

mkstr: create an error message Ale by massaging C source.mkstr(l) 
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Permuted Index 


regexp: regular expression compile and 
eqn, neqn, checkeq; format 

maximum-value functions, 
maximum-value functions, max, 
functions, max, maxO, amaxO, 
max, maxO, amaxO, maxi, amaxl. dmaxl: Fortran 


bed, ppt: convert to antique 

malloc, free, realloc, calloc: main 
.mem, kmem: core 
plock: lock process, text, or data in 
sort: sort or 
acetmerg: 
lines of one file, paste: 

mkstr: create an error 
minimum-value functions, 
minimum-value functions, min. 
functions, min, minO, aminO, 
min, minO, aminO, mini, aminl, dminl: Fortran 

a68: 


newsoutput: notesfUe utility programs. 

. file, 
source. 

mm: the 

mmchek: check usage of 
mm: print out documents formatted with the 

macros. 

delimiters, 

slides. 

functions, 
chmod: change 
umask: set Ale-creation 
chmod: change 
getty : set terminal type, 
bs: a compiler/interpreter for 
frexp,Idexp, 
utime: set file access and 
long: system calls 
long: standard procedures 
touch: update date last 
a.out: format of programs and 
a.out: format of programs and 
runacct,/ chargefee, ckpacct, dodisk, lastlogin, 

uusub: 


documents. 

curses: screen functions with “optimar* cursor 

mount: 
mount, umount: 

setmnt: establish 

mnttab: 

mvdir: 

cp. In, mv: copy, link or 
Iseek: 

hk: RK611/RK06. RK07 
hp: RP04/05/06. RM02/03 
rl, hi: RL01/RL02 
rm: RU02/03/05 
index. 

generate/ drand48, erand48, lrand46, nrand48. 


dz, dh: DZ-11, DH-11 asynchronous 
generate configuration file and reconfigure 


match routines.regexp(7) 

mathematical text for nrofT or trofi.«qn(l) 

matherr: error-handling function.matherr(3M) 

max, maxO, amaxO, maxi, amaxl, dmaxl: Fortran . max(3f) 
maxO, amaxO, maxi, amaxl. dmaxl: Fortran .... max(3f) 
maxi, amaxl, dmaxl: Fortran maximum-value . . . max(3f) 

maximum-value functions.max(3f) 

mclock: return Fortran time accounting.mclock(3f) 

med: screen editor.med(l) 

media.bcd(6) 

mem, kmem: core memory.mem(4) 

memory allocator..malloc(3C) 

memory.mem(4) 

memory.plock(2) 

me.^ge flies. .sort(l) 

merge or add total accounting files.acctmerg(8) 

merge same lines of several files or subsequent . . . paste(l)> 

mesg ; permit or deny messages.mesg(l) 

message file by massaging C source.mkstr(l) 

min, minO, aminO, mini, aminl. dminl: Fortran . . . min(3f) 

minO, aminO, mini, aminl. dminl: Fortran.min(3f) 

mini, aminl, dminl: Fortran minimum-value .... min(3f) 

minimum-value functions.min(3f) 

MIT assembler.a68(l) 

mkdir : make a directory.mkdir(l) 

mkfs: construct a file system,.mkf3(8) 

mknf, rmnf, nfxmit, nfrev, nfarchive, newsanput, . . . note3(8) 

mknod: build special file.mknod(8) 

mknod: make a directory, or a special or ordinary . . mknod(2) 
mkstr: create an error message file by massaging C . mkstr(l) 

mktemp: make a unique file name.mktemp(3C) 

MU m,acro package for formatting documents.mm(7) 

mm macros and eqn delimiters.mmchek(l) 

MU macros.mm(l) 

mm: print out documents formatted with the UM . . mm(l) 
mm: the MU macro package for formatting documents. mm(7) 
mmchek: check usage of mm macros and eqn .... mmchek(l) 

mmt, mvt: typeset documents, view graphs, and . . . mmt(l) 

mnttab: mounted file system table.mnttab(5) 

mod, amod, dmod: Fortran remaindering intrinsic . . mod(3f) 

mode.chmod(l) 

mode mask.umask(l) 

mode of file.chmod(2) 

modes, speed, and line discipline.getty(8) 

modest-sized programs.bs(l) 

modf: split into mantissa and exponent.frexp(3C) 

modification times.utime(2) 

modified for long arguments.long(2) 

modified for long arguments.long(3C) 

modified of a file.touch(l) 

modules.ahdr(5) 

modules.a.out(5) 

monacct, nuUadm, pretmp, prdaily, prtacct.acctsh(8) 

monitor: prepare execution profile.monitor(3C) 

monitor uucp network.uusub(8) 

moo: guessing game.moo(6) 

more, page: file perusal filter for ert viewing.more(l) 

mosd: the OSDD adapter macro package for formatting mosd(7) 

motion.curses(3) 

mount a file system..mount(2) 

mount and dismount file system..mount(8) 

mount: mount a file system. .mount(2) 

mount table.sctmnt(8) 

mount, umount: mount and dismount file system. . . mount(8) 

mounted file system table.mnttab(5) 

move a directory.mvdir(8) 

move files.cp(l) 

move read/write file pointer.lseek(2) 

moving-head disk.hk(4) 

moving-head disk.hp(4) 

moving-head disk.rl(4) 

moving-head disk..rm(4) 

mptx; the macro package for formatting a permuted mptx(7) 

mrand46, jrand48. arand48. seed48, lcong48: .... drand48(3C) 

ms: macros for formatting manuscripts.ms(7) 

msgs: system messages and junk mail program. . . . msgs(l) 

mt: magnetic tape manipulating program..nit(l) 

multiplexers.dz(4) 

MUNDC newconf: .newconf(8) 
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Permuted Index 


cp. In, 
mmt, 

pipe: Pipes and 
system, uname, ethnarne: get 
log, alog, dlog, clog: Fortran 

anint, dnint, nint, idnint: Fortran 
/etc/Utah: 
or trolT. eqn, 

cqnchar special character definitions for eqn and 

news: USENET 
uusub: monitor uucp 
maii.nc: mail(l) using the 
/etc/groupmap: user and group id mappings for the 
/etc/NCsetup: initialise the 
/etc/utab: neighbours known to the 
reconfigure UUNOC. 

news: USENET network 
expire: remove outdated 
inews: submit 
postnews: submit 
readnews: read 
sendnews: send 
uurec: receive processed 
checknews: check to see if user has 
news: print 

notes, autoseq, nfpipe, nfprint, nfstats: a 

mknf, rmnf, nfxmit, nfrev, nfarchive, 
mknf, rmnf, nfxmit, nfrev, nfarchive, newsinput, 

checknews(l). 
dbminit, fetch, store, delete, ftrstkey, 
programs, mknf, rmnf, nfxmit, nfrev, 
syste.m. 
notes, autoseq, 
notes, autoseq, nfpipe, 
utility programs, mknf, rmnf, nfxmit. 
notes, autoseq, nfpipe, nfprint, 
notesflle utility programs, mknf, rmnf, 


alter priority of running process by changing 

anint, dnint, 


/etc/mksys; make a remote system 

nice, 

setjmp, longjmp: 
functions, and, or, xor, 
system. 

nfcomment; a user interface to the 
nfxmit, nfrev, nfarchive, newsinput, newsoutput: 
lcong48: generate/ drand48, erand48, lrand48, 
soelim: eliminate .so's from 
eqn, neqn, checkeq: format mathematical text for 
tbl: format tables for 
colcrt: filter 
trolT, 

checknr: check 
derolT: remove 
null: the 

chargefee, ckpacct, dodisk, lastlogin, monacct, 

nl: line 
size: size of an 
lorder: find ordering relation for an 
strings: And the printable strings in a 

od : 

pack : packs or unpacks many flies <—> 
a program file including aliases and paths (esh 
fopen, freopen, fdopen: 
dup: duplicate an 
open: 


mv: a macro package for making view graphs. .... mv(7) 

mv: copy, link or move flies.cp(l) 

mvdir: move a directory. .. mvdir(8) 

mvt; typeset documents, view graphs, and slides. . . mmt(l) 

named pipes.pipc(4) 

name/ethernet-identifleation of current UNIX .... uname(2) 

natural logarithm intrinsic function. ..log^if) 

ncheck: generate names from i*numbers.ncheck(6) 

nearest integer functions.round(3f) 

neighbours known to the Newcastle Connection. . . . utab(5N) 
neqn, checkeq: format mathematical text for nrofl . eqn(l) 

..eqnchar(7) 

network news article, utility flies.news(5) 

netirork..uusub(8) 

Newcastle Connection instead of uucp.. . . . mQil(lN) 

Newcastle Connection, /etc/pwmap.pwmap(5N) 

Newcastle Connection tables in a process.NCsetup(8N) 

Newcastle Connection.utab(5N) 

newconf: generate conflguration flic and.newconf(8) 

newgrp: log in to a new group.newgrp(l) 

news article, utility flies. .news(5) 

news articles.expire(8) 

news articles..inews(l) 

news articles. .. postnews(l) 

news articles.readncws(l) 

news articles via mail.sendnews(8) 

news articles via mail..uurec(8) 

.checknews(l) 

news items.news(l) 

news: print news items.new 3 (l) 

news system. .notes(l) 

news: USENET network news article, utility flies. . . . ncws(5) 
newsinput, newsoutput: notesflle utility programs. . . notes(8) 

newsoutput: notesflle utility programs.notes(8) 

newsrc: information file for readnews(l) and.newsrc(5) 

nextkey: data base subroutines.dbm(3X) 

nfarchive. newsinput, newsoutput: notesflle utility . . notes(8) 

nfcomment: a user interface to the notesflle.nfcomment(3) 

nfpipe, nfprint, nfstats: a news system.notes(l) 

nfprint, nfstats: a news system. ..notes(l) 

nfrev, nfarchive, newsinput, newsoutput: notesflle , . notes(8) 

nfstats: a news system..notes(l) 

nfxmit, nfrev, nfarchive, newsinput, newsoutput: . . notes(8) 

nice: change priority of a process.nice(2) 

nice, nohup: run a command at low priority.nicc(l) 

nice, renice:.renice(8) 

nint. idnint: Fortran nearest integer functions. . . . round(3f) 

nl: line numbering filter.nl(l) 

nlist: get entries from name list. . ... . . . . . , . nlist(3C) 

nm: print name list. . . . ... . .... ..nm(l) 

node.mksys(8N) 

nohup: run a command at low priority.. nice(l) 

non-local goto.setjmp(3C) 

not, Ishift, rshift: Fortran bitwise boolean.bool(3f) 

notes, autoseq, nfpipe, nfprint. nfstats: a news . . . notes(l) 

notesflle system .nfcomment(3) 

notesflle utility programs, mknf, rmnf, . . . ..... notcs(8) 

nrand48. mrand48, irand48, srand48. seed48.drand48(3C) 

nrofT input.soelim(l) 

nrofi or trofT. .eqn(l) 

nrofT or troff. .tbl(l) 

nroff output for CRT previewing.colcrt(l) 

nroff: typeset or format text.troff(l) 

nroff/troff flics.checknr(l) 

nroff/troff, tbl, and eqn constructs.deroff(l) 

null flic.null(4) 

null; the null flic.null(4) 

nulladm, pretmp, prdaily, prtacct, runacct,/ .... acctsh(fl) 

numbering Alter.nl(l) 

object flic..sizc(l) 

object library.lorder(l) 

object, or other binary, file.strings(l) 

octal dump.od(l) 

od : octal dump.od(l) 

...pack(l) 

only), which: locate.which(l) 

open a stream .fopen(3S) 

open file descriptor. .dup(2) 

open for reading or writing. ..open(2) 


UUNIX Version 1.5 


- 19 - 


February 24, 1984 










































































Permuted Index 


igctstT. tgoto. ipula: terminal independent 
strrehr. strpbrk, atrapn. atreapn, atrtok: airing 
join; relational databaae 
dcopy: copy file syatema for 
curaea; acrecn functiona with 
getopt: get 
fcntl; file control 
stty: aet the 
getopt: parse command 
Ipctrl: set 
boolean functions, and, 
lorder: find 

mknod: make a directory, or a special or 

vi; screen 
documents, mosd; the 
disk. 

expire: remove 
ecvt, fevt: 

fold; fold long lines for finite width 
colcrt; Alter nrofl 
printf, fprintf, sprintf; 
commands, acetdisk, acctdusg, aceton, acctwtmp: 

chown: change 
chown, chgrp: change 
quot: summarize flle system 
disk, ot, 

pack : 
more, 
tk: 

me; macros for formatting 
Ip : 

Ipctrl; set options on the 
getpgrp, getppid; get process, process group, and 

getopt; 

pc; 


getpwuid. getpwnam, setpwent, endpwent: get 

putpwent; write 
passwd: 
getpass; read a 
passwd; change login 
pwck, grpek; 
subsequent lines of one file. 

getewd; get 

which; locate a program file including aliases and 
grep, egrep. fgrep; search a file for a 

awk; 


popen. 

Bip; basic functions for BIP, the 
mesg : 

mptx; the macro package for formatting a 

ptx; 

acet: 

acetems: command summary from 
messages, 
more, page; file 
pti: 
tc; 

split; split a flle into 
tee; 
pipe: 

pipe; Pipes and named 


Iseek: move read/write flle 


bbp: Basic Block 
sbp; SimpUAed Basic Block 
prmail; print out mail in the 
banner: make long 


open; open for reading or writing.open(2) 

operation routines, tgetent, tgetnum, tgetAag, . • . termcap(3) 

operations, /artrepy, stmepy, strlen, strehr,.string(3C) 

operator. ..join(l) 

optimal access time.• • ..dcopy(8) 

"optimal" cursor motion. ..curses(3) 

option letter from argv.getopt(3C) 

options.fcntl(7) 

options for a terminal.»tty(l) 

options.getopt(l) 

oDtions on the parallel line printer.. . Ipctrl(l) 

or, xor. not, Ishift, rshift: Fortran bitwise .bool(3f) 

ordering relation for an object library.lordcr(l) 

ordinary Ale.mknod(2) 

oriented (visual) display editor based on ex.vi(l) 

OSDD adapter macro package for formatting .... mosd(7) 
ot. ox: TM 503/TM 603/TU 703 disk. TU 100-4 Aoppy ot(4) 

outdated news articles..expire(8) 

output conversion.ecvt(3C) 

output device.fold(l) 

output for CRT previewing.colcrt(l) 

output formatters.printf(3S) 

overview of accounting and miscellaneous accounting acct(8) 

owner and group of a Ale.chown(2) 

owner or group.chown(l) 

ownership.quot(8) 

ox: TU 503/TU 603/TU 703 disk, TU 100-4 Aoppy . . ot(4) 

pack : packs or unpacks many Ales <—> one.pack(l) 

packs or unpacks many Ales <—> one.pack(l) 

page: Ale perusal Alter for ert viewing.more(l) 

paginator for the Tektronix 4014.tk(l) 

papers.me(7) 

parallel line printer.Ip(^) 

parallel line printer.Ipctrl(l) 

parent process IDs. getpid,.getpid(2) 

parse command options...getopt(l) 

Pascal compiler...pc(U 

. passwd; change login password.passwd(l) 

passwd; password Ale.passwd(5) 

password Ale entry, getpwent..getpwent(3C) 

password Ale entry. putpwcnt(3C) 

password Ale. ..passwd(5) 

password..getpass(3C) 

password..passwd(l) 

password/group Ale checkers.pwck(0) 

paste; merge same lines of several Ales or.paste(l) 

path-name of current working directory.getcwd(3C) 

paths (cah only).. • • which(l) 

pattern.grep(l) 

pattern scanning and processing language.awk(l) 

pause: suspend process until signal.pause(2) 

pc; Pascal compiler.pc(l) 

pclose; initiate I/O to/from a process.popen(3S) 

PCS bitmap display.bip(3) 

permit or deny messages..mesg(l) 

permuted index.* • mptx(7) 

permuted index.pt*(l) 

per-process accounting Ale format.acct(5) 

per-process accounting records.acctcms(8) 

perror, syauarrlist, sys-nerr, ermo: system error . . peiTor(3C) 

perusal Alter for ert viewing.more(l) 

phototypesetter interpreter.. pti(l) 

phototypeaetter simulator.tc(l) 

pieces..split(l) 

pipe: create an interprocess channel.pipe(2) 

pipe Atting.. tee(l) 

pipe: Pipes and named pipes.. pipe(4) 

Pipes and named pipes. .pipeC^) 

pipes.pipe(4) 

plock; lock process, text, or data in memory.plock(2) 

plot; graphics Alters.plot(lG) 

plot: graphics interface.plot(5) 

plot: graphics interface subroutines.plot(3X) 

pointer..lseek(2) 

popen, pclose: initiate I/O to/from a process.popen(3S) 

Port Interface.bbp(4) 

Port Interface.sbp(4) 

post oAice.prmail(l) 

posters.banner(6) 
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root functions, exp. log. log 10. 
exp, log, log 10. pow, sqrt: exponential, logarithm, 

brc, bcheckrc, rc, 
bed, 

/ckpacct, dodisk, laartlogin, monacct, nuUadm, 
/dodisk, lastlogin, monacct, nulladm, pretmp, 

monitor; 

prep; 

epp: the C language 
colcrt; filter nrofl output for CRT 
unget; undo a 
types: 
Ipd: line 
Ibp: LBP-lO Laser Beam 
Ip : parallel line 
Ipctrl; set options on the parallel line 

Ipr; line 
vp: Versatec 

nice, nohup; run a command at low 
nice; change 
renicc; alter 

exit, —exit; terminate 
fork; create a new 
inittab; script for the init 
kill; terminate a 
initialise the Newcastle Connection tables in a 
nice; change priority of a 
popen, pclose; initiate I/O to/from a 
getpid, getpgrp, getppid; get 
plock: lock 
wait; await completion of 
checklist; list of file systems 
uurec; receive 

kill: send a signal to a process or a group of 
killall; kill all active 
fuser: identify 
prep: prepare text for statistical 
shutdown: terminate all 
m4; macro 
alarm: set a 


prof; display 
monitor: prepare execution 
profll: execution time 

ah, rah: shell, the standard/restricted command 

ifprolog: The 
arithmetic; 
true, false; 

/lastlogin, monacct, nulladm, pretmp, prdaily, 
8eed46, lcong4a: generate uniformly distributed 


ungetc; 
on a stream, 
stream, putc. 


utmp file entry, getutent, getutid, getutline, 
putc, putchar, fputc. 


qsort: 

generator, 
ranlib; convert archives to 


postnews: submit news articles.postnews(l) 

pow, sqrt; exponential, logarithm, power, square . . exp(3M) 

power, square root functions..exp(3U) 

powerfail: system initialization shell scripts.brc(6) 

ppt: convert to antique media.bcd(6) 

pr: print files.pr(l) 

pretmp, prdaily, prtacct, runacct, shutacct,/ .... acetshfa) 
prdaiiy, prtacct, runacct, shutacct, startup,/ .... acct3h(8) 

prep; prepare text for statistical processing.prcp(l) 

prepare execution profile.monitor(3C) 

prepare text for statistical processing. .prep(l) 

preprocessor.cpp(l) 

previewing.colcrt(l) 

previous get of an SCCS file.unget(l) 

primitive system data types.types(7) 

printer daemon..lpd(8) 

Printer Interface...lbp(4) 

printer.. ..lp(4) 

printer.. Ipctrl(l) 

printer spooler...Ipr(l) 

printer-plotter..^(4) 

printf, fprintf, sprintf; output formatters.printf(3S) 

priority.nice(l) 

priority of a process.nice(2) 

priority of running process by changing nice.renice(8) 

prmail: print out mail in the post office.prmail(l) 

process.. . cxit(2) 

process. ... fork(2) 

process... iiuttab(5) 

process... kill(l) 

process. /etc/NCsetup:.NCsetup(8N) 

process... nice(2) 

process...popen(3S) 

process, process group, and parent process IDs. . . . getpid(2) 

process, text, or data in memory.pIock(2) 

process..wait(l) 

processed by fsck. checkHst(5) 

processed news articles via mail.uurec(8) 

processes.kill(2) 

processes.kiIIaU(8) 

processes using a file or file structure.fuser(8) 

processing.prep(l) 

processing.ahutdown(8) 

processor.m4(l) 

process's alarm clock.alarm(2) 

prof: display profile data.. prof(l) 

profll; execution time profile.profll(2) 

profile data. .prof(l) 

profile..monitor(3C) 

profile..profll(2) 

profile: setting up an environment at login time. . . . proflle(5) 

programming language.ah(l) 

Prolog interpreter system. ... ifprolog(l) 

provide drill in number facts.arithmctic(6) 

provide truth values.. true(l) 

prs: print an SCCS file.prs(l) 

prtacct, runacct, shutacct, startup, turnacct:/ . . . acctah(8) 

ps; process status. .P9(l) 

pseudo-random numbers. /mrand46. jrand40. srand48, drand48(3C) 

pstat; print system facts.pstat(8) 

pti; phototypeaetter interpreter.pti(l) 

ptrace; process trace.ptrace(2) 

ptx; permuted index.ptx(l) 

push character back into input stream. .ungetc(3S) 

putc, putchar, fputc, putw: put character or word . . putc(3S) 
putchar, fputc. putw: put character or word on a . . putc(3S) 

putpwent; write password file entry.putpwent(3C) 

puts, fputs: put a string on a stream. . ... puta(3S) 

pututline, setutent, endutent, utmpname; access . . getut(3C) 

putw: put character or word on a stream. .putc(3S) 

pwck, grpek; password/group file checkers.pwck(8) 

pwd; working directory name.pwd(l) 

qsort: quicker sort.. . qsort(3C) 

quicker sort. .qsort(3C) 

quiz; test your knowledge.quiz(6) 

quot: summarize file system ownership.quot(8) w 

rand, srand: Fortran uniform random-number .... rand(3f) 

rand, srand; random number generator.rand(3C) 

random libraries. .ranlib(l) 
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rand, srand: 
rand, srand: Fortran uniform 


ratfor: 
brc, bcheckrc, 
getpass: 
read; 

mail, rmail; send mail to users or 
readnews: 

line; 

open; open for 

newsrc; information flic for 
Iscek; move 

char; explicit Fortran type/ Lnt. iflx, idint, 

malloc, free, 
signal: specify what to do upon 
signal: specify Fortran action on 
uurec; 
recnews; 
recnews; 


newconf; generate configuration flle and 
command summary from per-process accounting 
fwtmp, wtmpflx; manipulate connect accounting 

ed, 

references in documents, 
refer, lookbib; find and insert literature 

reform: 

regex, 

make; maintain, update, and 

routines, 
regexp: 
regemp: 
regex, regemp; 
comm: select or 
lorder: And ordering 
unify 
join: 

strip: remove symbols and 
Aoor, ceil, fmod, fabs: Aoor. ceiling. 

mod. amod. dmod: Fortran 
leave: 
calendar. 

/etc/usam: initiate a UNIX server for a 
usTv: UNIX server for a 
/etc/mkalias: create an alias to a 
rje: RJE 
/etc/rmsys: remove a 
/etc/mksys: make a 
unite: enable a 
rmdel; 
/etc/rmsys: 
colrm: 
unlink; 
rm, rmdir ; 
deroA; 
expire: 
strip; 
changing nice. 

Ale system consistency check and interactive 

uniq: report 
yes; be 
sar: system activity 
fseek, fteU, rewind: 

lock: 


restor: incremental Ale system 
getarg: 
getenv. 
mclock: 
len: 
index; 


random number generator... 

random-number generator...rend(3f) 

ranlib; convert archives to random libraries.ranlib(l) 

ratfor: rational Fortran dialect.ratfor(l) 

rational Fortran dialect..^ 

rc, powerfail; system initialization shell scripts. . . . brc(8) 

read a password.getpass(3C) 

read from Ale.read(2) 

readmail.mail(l) 

read news articles.readnews(l; 

read one line.. line(l) 

read: read from Ale. 

readnews: read news articles.readnewsvl; 

readnews(l) and checknew3(l).newsrc(5) 

read/write Ale pointer.^***^/?L 

real, Aoat, sngl, dble, empix, dcmplx, ichar.ftype(3f) 

realloc, calloc: main memory allocator.malloc(3C) 

receipt of a signal... 

receipt of a system signal. ..aignaH3f) 

receive processed news articles via mail.uurec(8) 

receive unprocessed articles via mail.recnew3(l) 

receive unprocessed articles via mail.recnew3(8) 

recnews; receive unprocessed articles via mail. . . • recnews(l) 

recnews: receive unprocessed articles via mail. . . . recnews(8) 

reconflgvire MUNDC.newconf(8) 

records, acetems;.acctcms(8) 

records.fwtmp(8) 

red: text editor.«d(l) 

refer, lookbib: And and insert literature.refer(l) 

references in documents.refer(l) 

reform; reformat text Ale.reform(l) 

reformat text Ale..reform(l) 

regemp: regular expression compile.regemp^) 

regemp: regular expression compile/execute.regex(3X) 

regenerate groups of programs. .. • 

regex, regemp: regular expression compile/execute. regex(3X) 
regexp: regular expression compile and match . . . rcgexp(7) 

regular expression compile and match routines. . . . regexp(7) 

regular expression compile.regempO^) 

regular expression compile/execute..rcgex(35p 

reject lines common to two sorted Ales.comm(l) 

relation for an object library.lordcr(l) 

relational data base system. . 

relational database operator. 

relocation bits. ... 

remainder, absolute value functions.Aoor(3M} 

remaindering intrinsic functions.mod(3f) 

remind you when you have to leave.leove(l) 

reminder service. 

remote client. usam(8^ 

remote client. 

remote Ale.mkalias(8N) 

(Remote Job Entry) to IBM. 

remote system name.rmsys(8r^ 

remote system node.mksys(6^ 

remote user to access the local system .unite(8N) 

remove a delta from an SCCS Ale.rmdel(l) 

remove a remote system name.rmsys(8N) 

remove columns from a Ale.colrm(l) 

remove directory entry.unbnk(2) 

remove Ales or directories.. rm(l) 

remove nroA/troA, tbl, and eqn constructs.deroA(l) 

remove outdated news articles.expire(8) 

remove symbols and relocation bits.strip(l) 

renice: alter priority of running process by .renice(8) 

repair, fsck, dfsck: . 

repeated lines in a Ale.uniq(l) 

repetitively aAirmativc.yesU) 

reporter.irncx 

reposition a stream.. f / \ ^ 

reserve a terminal. 

restor: incremental Ale system restore.restor(8) 

restore. 

return Fortran command-line argument.getarg(3f) 

return Fortran environment variable.getenv(3f) 

return Fortran time accounting.mclock(3f) 

return length of Fortran string. . 

return location of Fortran substring.. index(3f) 
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Slat: data 

rcverai; rcverai, a game of dramatic 
col; flJter 
rer; 
rcverai; 

faeek, ftell, 
creat; create a new file or 
send; gather Ales and submit 
rjc: 

rjestat: 

console. 

rk : RK-tl/RK03 or 
Ixk: RKail/RK06. 

rk : 
hk; 

rl, hi; 


hp: RP04/05/08. 

rm; 

mail, 

rm, 

newsoutput: notesflle utility programs, mknf, 

chroot: change 
chroot; change 

pow, sqrt: exponential, logarithm, power, square 
sqrt, dsqrt, csqrt; Fortran square 
regexp: regular expression compile and match 
tgoto, tputs: terminal independent operation 

hp: 

programming language, sh, 
and, or. xor, not, Ishift, 
nice, nohup: 
excr: 
runacct; 

/monacct, nuUadm, pretmp, prdaily, prtacct, 
renice: alter priority of 

rx ; 

rx : RXO1 or 


sal, 
sal, sa2. 


brk, 

bfs: big Ale 
awk: pattern 

ede: change the delta cominentary of an 
comb: combine 
delta: make a delta (change) to an 
sact: print current 
get: get a version of an 
prs: print an 
rmdel: remove a delta from an 
scesdiA: compare two versions of an 
sccsAle: format of 
unget: undo a previous get of an 
val; validate 
admin: create and administer 
what: identify 


clear: clear terminal 
emacs: a 
med: 


returned by etat system caU.stat( 7 ) 

rev: reverse lines of a Ale.. rcv(l) 

reversals.; ] ; reversi( 6 ) 

reverse line feeds.col(l) 

reverse lines of a Ale.rev(l) 

reversi, a game of dramatic reversals.reversi( 6 ) 

reversi: reverad, a game of dramatic reversals.revcrsi( 6 ) 

rewind: reposition a stream. .. fscek(3S) 

rewrite an existing ond.creat( 2 ) 

RJEjobs..send(lC) 

RJE (Remote Job Entry) to IBU.rje( 8 ) 

rje: RJE (Remote Job Entry) to QM... rje( 8 ) 

RJE status report and interactive sUtus console. . . rjestat(lC) 
rjestat: RJE status report and interactive status . . . riestatdC) 

rk . RK-11/RK03 or RK05 disk.rk( 4 ) 

RK05 disk.... . . rk( 4 ) 

RK07 moving-head disk. ..hk( 4 ) 

RK-ll/RK03or RKOSdisk.rk( 4 ) 

RK811/RK08, RK07 moving-head disk.1^(4) 

rl, hi: RL01/RL02 moving-head disk.r!( 4 ) 

RL01/RL02 moving-head disk.ri( 4 ) 

rm: RU02/03/05 moving-head disk.rm( 4 ) 

rm, rmdir : remove Ales or directories.rm(l) 

RM02/03 moving-head disk.hp( 4 ) 

RU02/03/08 moving-head disk.rm( 4 ) 

rmail; send mail to users or read mail.mai](l) 

rmdel: remove a delta from an SCCS Ale.rmdei(l) 

rmdir : remove Ales or directories.rm(l) 

rmnf, nfxmit, nfrev, nfarchive. newsinput,.notes( 8 ) 

rogue: Exploring The Dungeons of Doom. . ..rogue( 6 ) 

root directory. chroot( 2 ) 

root directory for a command.chroot( 8 ) 

root functions, exp, log, loglO.ezp( 3 y) 

root intrinsic function..sqrt( 3 f) 

roMXlnen .regexp( 7 ) 

routines, tgetent, tgetnum, tgctAag, tgeutr.termcap(3) 

RP04/05/08, RU02/03 moving-head disk.hp( 4 ) 

rsh: shell, the standard/restricted command .... ah(l) 

rshift: Fortran bitwise boolean functions.bool( 3 f) 

run a command at low priority.nice(l) 

run a program on another system..excr(lK) 

run daily accounting.runacct( 8 ) 

runacct: run daily accounting. ..runacct( 8 ) 

runacct, ahutacct, startup, tumacct: shell/.acctsh( 6 ) 

running process by changing nice. ..renice( 8 ) 

rx : RXOl or RX02 Aoppy disk.rx( 4 ) 

RXOl or RX02 Aoppy disk.rx( 4 ) 

RX02 Aoppy disk...rx(4) 

rxctrl: Aoppy disk manipulating program. ...... rxctrl(l) 

sa. aceton: system accounting.. 9 a( 8 ) 

sal, sa 2 , sadc: system activity report package. . . . aar( 8 ) 

8 a 2 . sadc: system activity report package.sar( 8 ) 

sact: print current SCCS Ale editing activity.sact(l) 

sadc: system activity report package.sar( 8 ) 

sag: system activity graph.aag(lG) 

sar: system activity reporter.sar( 1 ) 

sbp: SimpliAed Basic Block Port Interface. 9 bp( 4 ) 

sbrk: change data segment space allocation. ..... brk(2) 
scanf, fscanf, sscanf: formatted input conversion. . . scanf(3S) 

scanner.bfs(l) 

scanning and processing language.awk(l) 

SCCS delta.cdc(l) 

SCCS deltas... ..comb(l) 

sees Ale.delta(l) 

SCCS Ale editing activity.8act(l) 

SCCS Ale.. get(l) 

SCCS Ale.. ..prs(l) 

SCCS Ale.rmdel(l) 

SCCS Ale.sccsdiA(l) 

SCCS Ale. . ....sccsAle(5) 

SCCS Ale.unget(l) 

SCCS Ale.val(i) 

SCCS Ales.admin(l) 

SCCS Ales.what(l) 

scesdiA: compare two versions of an SCCS Ale.sccsdiA(l) 

sccsAle; format of SCCS Ale.sccsAle(5) 

screen..clcar(l) 

screen editor.. . emacs(l) 

screen editor.med(l) 
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curses: 
ex. vi: 

iniUab: 

rc, powerfail: system initialization shell 

St: 

grep, egrep, fgrep: 

acctcom: 
Isearch; linear 
bsearch: binary 
hscarch, hcreate, hdestroy: manage hash 
isearch. tdclete, twalk: manage binary 
man: print 

/lrand48. nrand48. mrand48. jrand48. srand48, 
brk, sbrk: change data 
comm: 
cut: cut out 
kUl: 

mail, rmail: 
sendnews: 

diction, explain: print wordy 
startrek: THE game based on the t.v. 

/etc/usam: initiate a UNIX 
usTv. UNIX 

/etc/setugi: alter user id of a UNIX 
/etc/stopnc: starts up (closes down) the file 
script: make typescript of terminal 

setuid. 

getgrent, getgrgid, getgmam. 

crypt. 


getpwent, getpwuid, getpwnam, 
profile: 

gettydefs: speed and terminal 

entry, getutent. getutid, getutline, pututline, 
programming language, 
xstr: extract strings from C programs to implement 

system: issue a 
system: issue a 
esh: a 

prtacct, runacct, shutacct. startup, tumacct: 
bre, bcheckrc, rc. powerfail; system initialization 

language, ah. rsh: 
/nulladm. pretmp, prdaily, prtacct, runacct, 

sdiiT: 

intrinsic function. 

login: 

pause: suspend process until 
signal: specify what to do upon receipt of a 
specify Fortran action on receipt of a system 

system signal, 
signal, 
kill: send a 
ssignal. gsignal: software 
fmt: 
sbp: 

tc: phototypesetter 
trigonometric functions. 

sin, dain, csin: Fortran 
sinh, dsinh: Fortran hyperbolic 

function. 

size: 

stctrl.stakip: special streamer features. 


mmt. mvt: typeset documents, view graphs, and 

ttyalot: find the 


screen functions with "optimar* cursor motion. . . . cursea(3) 

screen oriented (visual) display editor based on . . . vi(l) 

script for the init process.inittab(5) 

script: make typescript of terminal session.script(l) 

scripts, bre, bcheckrc, .brc(8) 

SCTll Streamer interface.»t(4) 

adifi: side-by-side difference program. .adifl(l) 

search a file for a pattern.grep(l) 

search and print process accounting lllc(s).acctcom(l) 

search and update.lsearch(3C) 

search.bsearch(3C) 

search tables.haearch(3C) 

search trees.tsearch(3C) 

sections of this manual.man(lb) 

sed: stream editor.sed(l) 

seed48. lcong48: generate uniformly distributed/ . . drand48(3C) 

segment space allocation.brk(2) 

select or reject lines common to two sorted flies. . . co.mm(l) 

selected flelds of each line of a file.cut(l) 

send a signal to a process or a group of processes. . kill(2) 

send: gather flies and submit RJE jobs.send(lC) 

send mail to users or read mail.mail(l) 

send news articles via mail.scndncws(a) 

sendnews: send news articles via mail.sendnews(8) 

sentences, interactive thesaurus for diction.diction(l) 

series...startrex(6) 

server for a remote client.usam(8N) 

server for a remote client.uarv(8N) 

server.setugi(8N) 

server spawner. /etc/startnc.startnc(8N) 

session.script(l) 

setbuf: assign buffering to a stream..8etbuf(3S) 

setgid: set user and group IDs.. • setuid(2) 

setgrent. endgrent: get group flle entry.getgrent(3C) 

setjmp, longjmp: non-local goto.. . setjmp(3C) 

setkey, encrypt: DES encryption.crypt(3C) 

setmnt: establish mount table.setmnt(8) 

setpgrp: set process group ID. 9 etpgrp( 2 ) 

setpwent, endpwent: get password file entry.getpwent(3C) 

setting lip an environment at login time.profllc(5) 

settings used by getty.gettydefs(5) 

setuid, setgid: set user and group IDs.setuid(2) 

setutent. endutent, utmpname: access utmp flle . . . getut(3C) 
sh, rsh: shell, the standard/restricted command . . sh(l) 

shared strings.xstr(l) 

shell command.system(3S) 

shell command from Fortran.system(3f) 

shell (command interpreter) with C-like syntax. . . . csh(l) 

shell procedures for accounting, /pretmp, prdaily, . acctah(8) 

sheU scripts.brc(8) 

shell, the standard/restricted command programming ah(l) 
shutacct, startup, tumacct: shell procedures for/ . . acctsh(8) 

shutdown: terminate all processing.shutdown(8) 

side-by-side difference program..sdiff(l) 

sign, isign, dsign: Fortran transfer-of-sign.aign(3f) 

sign on..login(l) 

signal.pause(2) 

signal.aignal(2) 

signal, signal:.. • signal(3f) 

signal: specify Fortran action on receipt of a . . . aignal(3f) 

signal: specify what to do upon receipt of a .signal(2) 

signal to a process or a group of processes. .kill(2) 

signals. .. ssignal(3C) 

simple text formatter.fmt(l) 

Simplified Basic Block Port Interface.sbD(4) 

sim^ator. 

sin, cos, tan, aadn, acos, atan, atan2:.trig(3M) 

sin. dsin, csin: Fortran sine intrinsic function.ain(3f) 

sine intrinsic function.ain(3f) 

sine intrinsic function.*inN(3f) 

sinh, cosh, tanh: hyperbolic functions.amh(3VI) 

sinh, dsinh: Fortran hyperbolic sine intrinsic .... amh(3f) 

size of an object file.sizep) 

size: size of an object file.adze(l) 

skip flies.stctrl(l) 

sleep; suspend execution for an interval.alcep(l) 

sleep: suspend execution for interval.alecp(3C) 

sUdea. 

slot in the utmp flle of the current user.ttyslot(3C} 
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spline: interpolate 
Fortran type/ int, iflx. iduit, real, float. 

sno: 

ssignal, gsdgnal: 

sort: 

qsort: quicker 

tsort: topological 
comm: select or reject lines conunon to two 
look: And lines in a 
soelim: eliminate 
whereis: locate 
indent: indent and format a C program 
mkstr: create an error message file by massaging C 
brk, sbrk: change data segment 
expand, unexpand: expand tabs to 
starts up (closes down) the file server 
fspec: format 
getty : set terminal type, modes, 
gettydefs: 

spell. 

spell, spellin, spellout: And 
spell, spellin, 

split: 

esplit: context 
frexp, Idexp, modf: 

uuclean: uucp 
Ipr: line printer 
printf, fprintf, 
function. 

functions.-exp, log, log 10. pow, 
log 10, pow, sqrt: exponential, logarithm, power, 
sqrt, dsqrt, csqrt: Fortran 
rand, 
rand, 

/erand46. Irand46. nrand46, mrand46, jrand46, 

scan/, fscanf. 


C 

■tkiis: set 
boot: 
stdio: 
long: 

■h, rth: shell, the 

/eto/startno, /eto/stopne: 

boot: standalone 
/pretrnp, prdaily, prtacct, runacct, shutacet, 


stat: data returned by 
prep: prepare text for 
A: list file names and 
ustat: get file system 
rjestat; RJE sUtus report and interactive 
terror, feof, clearerr, flleno; stream 
uustat: uucp 
ps: process 
rjestat: RJE 
stat, fstat: get Ale 
Ales. 


wait: wait for child process to 
subroutines, dbminit, fetch, 
strlen, strehr, strrehr, strpbrk, strspn, strespn,/ 
/strncat, stremp, strnemp, strepy, strnepy, strlen, 
strrehr, strpbrk, strspn,/ streat, strncat. 
strspn, strespn,/ streat, strncat, stremp, strnemp, 
strnepy, strlen, strehr, strrehr, strpbrk. strspn, 

sed: 

felose, Alush: elose or flush a 


smooth eurve.. .. 

sngl, dble, emplx, demplx, iehar, char: explicit 

sno; SN030L interpreter.. . 

SNOBOL interpreter.. 

soelim: eliminate .so’s from nroff input. . . . 

software signals. 

sort or merge Ales.. 

sort... 


sort: sort or merge Ales. . 

sort... 

sorted Ales. 

sorted list. . .. 

.8o‘s from nroff input.. . . . 

source, binary, and or manual for program. 

source... 

source. 

space allocation.. . . . 

spaces, and vice versa. 

spawner. /etc/startnc, /etc/stopnc: . . . 

speciAcation in text Ales. 

speed, and line discipline. 

speed and terminal settings used by getty. . 
spell, spellin, spellout: And spelling errors. . 

spellin, spellout: And spelling errors. 

spelling errors.. 

spellout: And spelling errors. ........ 

spline: interpolate smooth curve. ...... 

split a Ale into pieces... 

split. 


split into mantissa and exponent. . 

split: split a Ale into pieces. 

spool directory clean-up. .. 

spooler... 

sprintf: output formatters. 

sqrt, dsqrt, csqrt: Fortran square root intrinsic . . . 
sqrt: exponential, logarithm, power, square root . . . 

square root functions, exp. log. 

square root intrinsic function.. 

srand: Fortran uniform random-number generator. . 

srand: random number generator.. 

srand46, seed46, lcong46: generate uniformly/ . . . 

sscanf: formatted input conversion. .. 

ssignal. gsignal: software signals.. 

St: SCTl 1 Streamer interface. .. 

stack frame layout. .. 

stacksixe. ...... 

standalone startup program.... 

standard buffered input/output package. 

standard procedures modifled for long arguments, 
standard/restricted command programming language. 

startrek: THE game based on the t.v. series. 

starts up (closes down) the Ale server spawner. . . . 

startup program. . 

startup, tumacct: shell procedures for accounting. . 

stat: data returned by stat system call. .. 

stat. fstat: get Ale status.. 

stat system call. . 

statistical processing. . 

statistics for a Ale system. ... 

statistics. 

status console.. 

status inquiries. 

status inquiry and job control. 

status. 

status report and interactive status console. 

status. 

slctrl,stskip: special streamer features, skip. 

stdio: standard buffered input/output package. . 

stime: set time. 

stksix: set stacksixe. 

stop or terminate. 

store, delete. Arstkey, nextkey: data base 
streat, strncat, stremp, strnemp, strepy, strnepy, . . 
strehr, strrehr, strpbrk, strspn. strespn. strtok:/ . . 
stremp, strnemp, strepy, strnepy, strlen, strehr, 
strepy, strnepy, strlen, strehr, strrehr, strpbrk, 
strespn, strtok: string operations, /strepy, . . 

stream editor. 

stream. . 


spline(lG) 
ftypc(3f) 
sno(l) 
sno(l) 
soelim(l) 
ssignai(3C) 
sort(l) 
qsort(3C) 
8ort(l) 
tsort(l) 
comm(l) 
look(l) 
soeli.m(l) 
whcreis(l) 
indcnt(l) 
mkstr(l) 
brk(2) 
cxpand(l) 
startnc(0K) 
fspec(5) 
getty(6) 
g«ttydefs(5) 
spell(l) 
spell(l) 
spell(l) 
spell(l) 
splinc(lG) 
split(l) 
csplit(l) 
frexp (3C) 
spUt(l) 
uuclean(8) 
Ipr(l) 
prmtf(3S) 
sqrt(3f) 
exp(3U) 
exp(3y) 
sqrt(3f) 
rand (3 f) 
rand (3 C) 
drand48(3C) 
scanf(3S) 
ssignal (3 C) 
st(4) 
stack(5) 
stksiz(l) 
boot(6) 
stdio(3S) 
longOC) 
«hTl) 

startrek(6) 

8tartnc(8K) 

boot(6) 

acctsh(6) 

stat(7) 

stat(2) 

stat(7) 

prep(l) 


ustat(2) 

rjestat(lC) 

ferror(3S) 

uuatat(lC) 

ps(l) 

rjcstat(lC) 

stat(2) 

8tctrl(l) 

stdio(3S) 

stime(2) 

stkaiz(l) 

wait(2) 

dbm(3X) 

string(3C) 

string(3C) 

string(3C) 

string(3C) 

string(3C) 

•ed(0 

fclose(3S) 
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Permuted Index 


fopen, freopcn, fdopen: open a 
fseck, ftell, rewind: repoailion a 
gctchar, fgetc, getw; get character or word from 
gets, fgets: get a strLng from a 
putchar, fputc, putw: put character or word on a 
puts, fputs: put a string on a 
setbuf: assign buffering to a 
ferror, fcof, clearerr, fiieno: 
ungetc: push character back into input 
stctrl.stskip: special 
St: SCTll 
gets, fgets: get a 
len: return length of Fortran 
puts, fputs: put a 
strchr, strrchr, strpbrk, strspn. strcspn, strtok: 

other binary, file, 
strings, xstr: extract 
strings: find the printable 
extract strings from C programs to implement shared 

basename: 

strcat, strncat, strcmp, strncmp, strcpy, stmcpy, 
strchr. strrchr, strpbrk, strspn, strcspn,/ strcat, 
strpbrk. strspn, strcspn,/ strcat, strncat, strcmp, 
strcspn./ strcat, strncat, strcmp, strncmp, strcpy, 
stmcmp, strcpy, strncpy, strlen, strchr. strrchr, 
/strcmp, stmcmp, strcpy, stmcpy, strlen, strchr, 
/strcpy, stmcpy, strlen, strchr, strrchr. strpbrk, 
strlen, strchr, strrchr, strpbrk, strspn, strcspn, 

struct: 

fuser: identify processes using a flle or file 

document. 

inews: 
postnews: 
send: gather files and 
intro: introduction to 
fetch, store, delete, firstkey, nextkey: data base 
plot: graphics interface 
paste: merge same lines of several files or 
index: return location of Fortran 


du: 

quot: 

acctcms: command 
sync: update the 
sync: update 
su: become 
style : analyze 
sleep: 
sleep: 
pause: 

swab: 
strip: remove 


csh: a shell (command interpreter) with C-like 
messages, perror, 
perror, sys—errlist, 
mnttab: mounted flle system 
/ e tc / ma pu-p ort—e adr: 
configuration information: 
sctmnt: establish mount 
hsearch, hcreate. hdestroy: manage hash search 

tbl: format 

/etc/NCsetup: initialise the Newcastle Connection 

tabs: set 

expand, unexpand: expand 
ctags: create a 

functions, sin, cos, 

tan, dtan: Fortran 
tanh, dtanh: Fortran hyperbolic 


stream. .fopen(3S) 

stream. . 

Stream, getc. 

stream .. 

stream putc.putc(3S) 

stream .put3(3S) 

stream. .setbti;(3|) 

stream status inquiries..ferror(3S) 

stream. .ungetc(3S) 

Streamer features, skip flies.stctrl(l) 

Streamer interface.st(4) 

string from a stream.gets(3S) 

string.len(3f) 

string on a stream .put3(3S) 

string operations, /strcpy, stmcpy, strlen, .string(3C) 

strings: find the printable strings in a object, or . . . strings(l) 

strings from C programs to implement shared .... xstr(l) 

strings in a object, or other binary, file.strings(l) 

strings, xstr: ..xstr(l) 

strip filename affixes..ba»name(l) 

strip: remove symbols and relocation bits.atrip(l) 

strlen, strchr, stirclir, strpbrk, strspn, strcspn,/ . . string(3C) 

sXmcat, strcmp, stmcmp, strcpy, stmcpy, strlen, . . stnng(3C) 
stmcmp, strcpy, stmcpy, strlen, strchr, strrchr, . . . string(3C) 
stmcpy, strlen, strchr, strrchr, strpbrk, strspn, , . . string(3C) 
strpbrk, strspn. strcspn, strtok: string/ /strcmp, . . string(3C) 
strrchr, strpbrk, strspn, strcspn, strtok: string/ . . string(3C) 

strspn, strcspn, strtok: string operations. .string(3C) 

strtok: string operations, /strcpy, stmcpy.string(3C) 

struct: structure Fortran programs.struct(l) 

structure Fortran programs.struct(l) 

structure.fuser(0) 

stty: set the options for a terminal.stty(l) 

style : analyze surface characteristics of a.style(l) 

su: become super-user or another user.yj(l) 

submit news articles.inew3(l) 

submit news articles, .pos*new3(l) 

submit RJS jobs.^nd(lC) 

subroutines and libraries.intro(3) 

subroutines, dbminit.dbm(3X) 

subroutines.plot(3X) 

subsequent lines of one flle. .paste(l) 

substrmg.Lndex(3f) 

sum and count blocks in a flle.sum(l) 

sum: sum and count blocks in a flle.sum(l) 

summarize disk usage. 

summarize flle system ownership.quot(8) 

summary from per-process accounting records. . . . acctcms(8) 

super block.sync(8) 

super-block.sync(2) 

supei^user or another user.su(l) 

surface characteristics of a document.style(l) 

suspend execution for an interval.aleep(l) 

suspend execution for interval.sleep(3C) 

suspend process until signal.pause(2) 

swab: swap bytes.swab(3C) 

swap bytes, .swab(3C) 

symbols and relocation bits.strip(l) 

sync: update super-block.sync(2) 

sync: update the super block.sync(8) 

syntax. 

sys—errlist. sys—nerr, ermo: system error.perror(3C) 

sys^err, ermo: system error messages.perror(3C) 

table.mnttab(5) 

table of ethernet addresses.ethmap(5N) 

table of interrupt vector and device addresses. . . conflnfo(4) 

table.setmnt(8) 

tables.. • • hsearch(3C) 

tables for nroff or troff.tbl(l) 

tables in a process.NCaetup(8K) 

tabs on a terminal.tabs(l) 

tabs: set tabs on a terminal.tabs(l) 

tabs to spaces, and vice versa.expand(l) 

tags me. 

tail: deliver the last part of a flle.tail(l) 

tan, asin, acos, atan, atan2: trigonometric.trig(3U) 

tan, dtan: Fortran tangent intrinadc function.tan(3f) 

tangent intrinsic function.tan(3f) 

tangent intrinsic function.tanh(3f) 
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Permuted Index 


function, 
sinh. cosh, 
tar : 


dun'.pdir: print the names of ftJes on a dump 

mt; magnetic 
filesave. 


derofi; remove nroff/troff, 


tsearch, 

tk: pcginator for the 
init, 

tmpAIe: create a 
tmpnam: create a name for a 


termcap: 

ctermid: generate file name for 
tgetent, tgetnum, tgetflag, tgetstr, tgoto. tputs: 

termio: general 
tty: controlling 
lock:’reserve a 
tty: get 
clear: clear 
script: make typescript of 
gettydefs: speed and 
stty: set the options for a 
tabs: set tabs on a 
ttyname, isatty: find name of a 
getty : Mt 

handle special functions of HP 2640 and 2621*series 

kill: 

shutdown: 

abort: 
exit, ^zit: 

wait: wait for child process to stop or 


quiz: 
d: 
d : 

ed,red: 
ex: 

reform: reformat 
fspec: format specification in 
eqn. neqn, checkeq: format mathematical 
prep: prepare 
fmt: simple 
plock: lock process, 
trolT, nrofi: typeset or format 
terminal independent operation routines, 
independent operation routines, tgetent, tgetnum. 

independent operation routines, tgetent, 
operation routines, tgetent, tgetnum, tgetflag, 
routines, tgetent, tgetnum, tgetflag. tgetstr, 
explain: print wordy sentences, interactive 

ttt: 

activity, timex: 

time: 

mclock: return Fortran 
at: execute commands at a later 
dcopy: copy file systems for optimal access 

profU: execution 
profile: setting up an environment at login 

stime: set 

time: get 

localtime, gmtime, asctime, tzset: convert date and 

clock: report CPU 

times: get process and child process 
utimc: set flic access and modification 
system activity. 

ot. ox; TU 503/TM 603/TU 703 disk, 
ot, ox: 


tanh, dtanh: Fortran hyperbolic tangent intrinsic . . tanh(3f) 

tanh: hyperbolic functions.. ainh(3M) 

tape archiver.tAr(l) 

tape.. dumpdir(8) 

tape manipulating program.mt(l) 

tapesave; daily/weekly UNIX file system backup. . . , fl]esavc(8) 

tar ; tape archiver.tar(l) 

tbl, and eqn constructs.derofT(l) 

tbl: format tables for nrofi or trofi.* . tbl(l) 

tc: phototypesettcr simulator.tcO) 

tdclcte, twaik: manage binary search trees.tsearch(3C) 

tee: pipe fitting.tee(l) 

Tektronix 4014..tk(l) 

telinit: process control initialization.init(8) 

temporary file.tmpflle(3S) 

temporary file.tmpnam(3S) 

term: conventional names.term(7) 

termcap: terminal capability data base.termcap(5) 

terminal capability data base.termcap(5) 

terminal.ctermid(3S) 

terminal independent operation routines.tcrmcap(3) 

terminal interface.termio(4) 

terminal interface.tty(4) 

terminal.lock(l) 

terminal name.tty(l) 

terminal screen.clear(l) 

terminal session.scrlpt(l) 

terminal settings used by getty.gettydcf3(5) 

terminal.etty(l) 

terminal.tabs(l) 

terminal.ttynamc(3C) 

terminal type, modes, speed, and line discipline. . . . getty(8) 

terminals, hp;.bp(l) 

terminate a process. .. kill(l) 

terminate all processing.ahutdown(8) 

terminate Fortran program. .abort(3f) 

terminate process..exit(2) 

terminate.wait(2) 

termio. general terminal interface.termio(4) 

test: condition evaluation command.test(l) 

test your knowledge.. quiz(6) 

text database functions. .. d(l) 

text database functions.d(3) 

text editor.«d(l) 

text editor. 

text file...reform(l) 

text files.fspec(5) 

text for nrofi or trofi..) 

text for statistical processing. . ..prep(l) 

text formatter.fmt(l) 

text, or data in memory.plock(2) 

text.trofT(l) 

tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: . . . termcap(3) 

tgetflag, tgetstr, tgoto, tputs: terminal.termcap(3) 

tgetnum, tgetflag, tgetstr, tgoto, tputs: terminal . . . termcap(3) 

tgetstr, t^oto, tputs: terminal independent .termcap(3) 

tgoto, tputs: terminal independent operation .... termcap(3) 

thesaurus for diction, diction, .diction(l) 

tic-tac-toe..ttt(6) 

time a command; report process data and system . . timez(l) 

time a command..ti.mc(l) 

time accounting.mclock(3f) 

time.at.(l) 

time.dcopy(8) 

time: get time.time(2) 

time profile...profll(2) 

time....prollle(5) 

time.stime(2) 

time: time a command.time(l) 

time...time(2) 

time to ASCII, ctime.ctime(3C) 

time used.clock(3C) 

times: get process and child process times.times(2) 

times.timcs(2) 

times. .uUme(2) 

timex; time a command; report process data and . . timex(l) 

tk: paginator for the Tektronix 4014.tk(l) 

TU 100-4 floppy disk.ot(4) 

TU 503/TU 603/TU 703 disk, TU 100-4 floppy disk. . ot(4) 
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Permuted Index 


interface, tm.ts: 


interface, 
toupper, tolower, 
popen, pclose: initiate I/O 
toupper, 
tsort; 

acctmerg: merge or add 


tgetent, tgetnum, tgetflag, tgetstr, tgoto, 

ptrace: process 
sign, isign. dsign; Fortran 
tr: 

toupper. tolower. toascii: character 
ftw; walk a file 

tsearch, tdelete, twalk; manage binary search 
sin, cos, tan, asin, acos, atan, atan2: 
checkeq: format mathematical text for nroff or 

tbl; format tables for nrofT or 
Itrofl, vtrofi; 

true, false: provide 
tm.ts: TM-11 /TU-10 magtape interface, 

trees. 


greek: graphics for the extended 
current user. 

prdaily, prtacct. runacct, shutacct, startup, 
startrek: THE game based on the 
tsearch, tdelete,' 

dble, cmplx, dcmplx, ichar, char: explicit Fortran 

file: determine file 
getty ; set terminal 
greek; graphics for the extended TTY-37 

types: primitive system data 
script: make 
nunt, mvt: 
trofi, nrolT; 

ctime, localtime, gmtime, asetime, 
getpw; get name from 


mount, 

current UNDC system. 

cat them, compact, 
compact, uncompact, ccat: compress and 

ul: do 
unget: 
expand, 


rand, srand: Fortran 
/jrand48, srand46, seed4a, lcong48: generate 

mktemp: make a 
system. 

uuto, uupick: public 
link, 

link, unlink: exercise link and 
umount: 
pack : packs or 
recnews: receive 


Til-11/TU-10 magtape interface, TS-11 magtape . . tm(4) 

tmpflle: create a temporary file.tmpfile(3S) 

tmpnam: create a name for a temporary file.tmpnam(3S) 

tm,ts: TM-ll/TU-10 magtape interface, TS-11 magtape tm(4) 

toascii: character translation.conv(3C) 

to/from a process.popen(3S) 

tolower, toascii: character translation.conv(3C) 

topological sort.tsort(l) 

total accounting files.acctmerg(8) 

touch: update date last modified of a file. ...... touch(l) 

toupper, tolower, toascii: character translation. . . . conv(3C) 

tplot; graphics filters.tpiot(lG) 

tputs: terminal independent operation routines. . . . termcap(3) 

tr; translate characters.tr(l) 

trace.ptrace(2) 

transfer-of-sign intrinsic function.sign(3f) 

translate characters.tr(l) 

translation.conv(3C) 

tree.ftw(3C) 

trees.tsearch(3C) 

trigonometric functions.trig(3M) 

trofi. eqn, neqn.eqn(l) 

trofi. nrofi: typeset or fornvat text.trofi(l) 

trofi.tbl(l) 

trofi to the CANON LBP or the Versatec V80.Itrofi(l) 

true, false; provide truth values.true(l) 

truth values.true( 1) 

TS-11 magtape interface.tm(4) 

tsearch, tdelete, twaik: manage binary search .... tsearch(3C) 

tsort: topological sort.tsort(l) 

ttt: tic-tac-toe.ttt(6) 

tty: controlling terminal interface.tty(4) 

tty; get terminal name.tty(l) 

TTY-37 type-box...greek(7) 

ttyna.me, isatty: find name of a terminal.ttyname(3C) 

ttyslot: find the slot in the utmp file of the.ttyslot(3C) 

turnacct: shell procedures for accounting, /pretmp. acctsh(8) 

t.v. series.startrek(6) 

twalk: .manage binary search trees.tsearch(3C) 

type conversion, /ifix, idint, real, float, s.ngl.ftype(3f) 

type.fi]e(l) 

type, modes, speed, and line discipline.getty(8) 

type-box.greck(7) 

types: primitive system data types.types(7) 

types.types(7) 

typescript of terminal session.script(l) 

typeset documents, view graphs, and slides.mmUl) 

typeset or format text.trorf(l) 

tzset: convert date and tinne to ASCII .ctime(3C) 

UED.getpw(3C) 

ul: do underlining.ul(l) 

ulimit: get end set user limits.ulimit(2) 

umask; set and get file creation mask. ........ umask(2) 

umask: set fUe-creation mode mask.. . umask(l) 

umount: mount and dismount file system. .mbunt(8) 

umount: unmount a file system. .umount(2) 

uname. ethname: get name/ethemet-identification of uname(2) 

uname: print name of current UNDC .uname(l) 

uncompact, ccat: compress and uncompress Ales, and compact(l) 

uncompress files, and cat them. .compact(l) 

underlining.ul(l) 

undo a previous get of an SCCS file.unget(l) 

unexpand: expand tabs to spaces, and vice versa. . . expand(l) 

unget: undo a previous get of an SCCS file.unget(l) 

ungetc: push character back into input stream. . . . ungetc(3S) 

uniform random-number generator.rand(3f) 

uniformly distributed pseudo-random numbers. . . . drand48(3C) 

unify relational data base system. .unify(l) 

uniq: report repeated lines in a file.uniq(l) 

unique file name.mktcmp(3C) 

unite: enable a remote user to access the local . . . unite(8N} 

units: conversion program..units(l) 

UNDC-to-UNDC file copy... uuto(lCj 

unlink; exercise link and unlink system calls.link(8) 

unlink: remove directory entry.unlink(2) 

unlink system calls.link(8) 

unmount a file system. .umount(2) 

unpacks many files <—> one.pack(l) 

unprocessed articles via mail.recnew 3 (l) 
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Permuted Index 


recnews: receive 
make; mamtain, 
touch: 

lacarch: linear search and 
sync; 
sync: 

du: summarize disk 
mmchek: check 
news: 

Connection, /etc/pwmap, /etc/groupmap: 

id; print 
setuid, setgid; set 
chfn; change full name of 
cuserid: character login name of the 
group/ getuid, geteuid. getgid, getegid; get real 

environ: 

checknews: check to see if 
/etc/setugi; alter 
Anger: 
nfcomment: a 
ullmit; get and set 
logname; login name of 
geteuid. getgid, getegid: get real user, effective 
su; become super-user or another 
unite: enable a remote 
And the slot in the utmp Ale of the current 
write; write to another 




mail, rmail; send mail to 
wall; write to all 
users; compact list of 
fuser: identify processes 
mail.nc: mail(l) 


news: USEhTET network news article, 
nfrev, nfarchive, newsinput, newsoutput; notesAle 

utmp, wtmp: 

pututline, setutent, endutent, utmpname; access 
ttyslot; And the slot in the 

getutid, gctutline, pututline, setutent, endutent, 

uucp: 

mail(l) using the Newcastle Connection instead of 

uusub; monitor 
uuclean: 
uustat: 


uucp, 
uucp, uulog, 
uuto. 


vtroff; troA to the CANON LBP or the Versatec 

val; 

abs: integer absolute 
abs, iabs, dabs, cabs, zabs: Fortran absolute 

getenv. 

finod, fabs: Aoor, ceiling, remainder, absolute 
true, false: provide truth 
getenv; return Fortran environment 

conAguration information: table of interrupt 
lint: a C program 
assert: 

expand, unezpand; expand tabs to spaces, and vice 

vp; 

Itroff, vtroA: troA to the CANON LBP or the 
vfont: font formats for the Benson*Varian or 

vc: 

get: get a 
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unprocessed articles via mail.recnews( 8 ) 

update, and regenerate groups of programs.make(l) 

update date last modiAed of a Ale.touch(l) 

.lsearch(3C) 

update super-block.sync( 2 ) 

update the super block.sync( 8 ) 

uptime; show how long system has been up.uptime(l) 

,.du(l) 

usage of mm macros and eqn delimiters.mmchekfll 

USENET network news article, utility Ales.news( 5 ) 

user and group id mappings for the Newcastle .... pwmap( 5 N) 

user and group IDs and names.icl(i) 

user and group IDs.sctuid( 2 ) 

.chfn(l) 

.cuserid(3S) 

user. eAective user, real group, and cAective .... geluid(2) 

user environment.environ( 7 ) 

user has news.checknews(l) 

user id of a UNDC server.setugi( 8 N) 

user information lookup program.Anger(l) 

user Lnterface to the notesAle system..nfcomrrent( 3 ) 

userUmits.ulimit( 2 ) 

• ..lognam,e(3X) 

user, real group, and eAective group IDs. getuid, . . getuid(2) 

user.su(l) 

user to access the local system. .unite( 8 N) 

user, ttyslot; .ttyslot(3C) 

user.write(l) 

users: compact list of users who are on the system . users(l) 

users or read mail.m,ail(l) 

users.wali( 8 ) 

users who are on the system.users(l) 

usi.ng a Ale or Ale structure.fuser( 8 ) 

using the Newcastle Connection instead of uucp.. . . mail(lN) 

usnr. UNIX server for a remote client.usrv( 8 N) 

ustat: get Ale system statistics.ustat(2) 

utility AJes.. news( 5 ) 

utility programs, mknf, rmnf. nfxmit.note 3 ( 8 ) 

utime: set Ale access and modiAcation times.utime(2) 

utmp and wtmp entry formats.utmp( 5 ) 

utmp Ale entry, getutent, getutid, gctutline.getut(3C) 

utmp Ale of the current user.ttyslot(3C) 

utmp, wtmp: utmp and wtmp entry formjats.ut.mp( 5 ) 

utmpname; access utmp Ale entry, getutent.getut(3C) 

uuclean; uucp spool directory clean-up.uuclean( 8 ) 

uucp installation made easy.uucp( 8 ) 

uucp.. mail.nc: .mail(lN) 

uucp network.uusub ( 8 ) 

uucp spool directory clean-up.uuclean( 8 ) 

uucp status inquiry and job control.uustat(lC) 

uucp: uucp installation made easy.uucp( 8 ) 

uucp, uulog. uuname; Unix to unix copy.uucp(lC) 

uulog, uuname: unix to unix copy.uucp(lC> 

uuname: Unix to Unix copy.. uucp(lC) 

uupick: public UNDC-to-UNDC Ale copy.uuto(lC) 

uurec: receive processed news articles via mail. . . . uurec( 8 ) 

uustat; uucp status inquiry and job control.uustat(lC) 

uusub: monitor uucp network.uusub( 8 ) 

uuto, uupick; public UNDC-to-UNDC Ale copy.uuto(lC) 

uux: unix to unix command execution.uux(lC) 

V80. ItroA.ItroA(l) 

val; validate SCCS Ale.val(l) 

validate sees Ale.val(l) 

value..abs( 3 e) 

value.abs( 3 f) 

value for environment name.getenv( 3 e) 

value functions. Aoor, ceil.Aoor(3U) 

values.true(l) 

variable.getenv( 3 f) 

vc: version control.vc(l) 

vector and device addresses..conAnfo( 4 ) 

veriAer.lint(l) 

verify program assertion.assert( 3 X) 

.cxpand(l) 

Versatec pnnter-plotter.vp( 4 ) 

Versatec V80.ItroA(l) 

Versatec.vfont( 5 ) 

version control.vc(l) 

version of an SCCS Ale.get(l) 
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Permuted Index 


sccsdifT: compare two 
Versatec. 
fo.’its. 
on ex. 

expand, unexpand: expand tabs to spaces, and 
mmt. mvt; typeset documents, 
mv: a macro package for making 
more, page: file perusal filter for crt 
vi: screen oriented 
checking. 

fs: file system format of system 
ItrofT, 


wait: 

ftw. 


whatis: describe 
whatconf: 

w. who is on and 
signal: specify 
crash - 
kernel. 

program. 

users: compact list of users 
whodo: 
from: 

w: 

who; 


fold: fold long lines for finite 
diction, explain: print 
cd:change 
chdir: change 
getcwd: get path-name of current 
pwd: 
write: 
putpwent: 
wall: 
write: 


open: open for reading or 
utmp, wtmp: utmp and 
utmp, 
fwtmp, 

command . 

functions, and, or, 

shared strings. 
jO, jl, jn, 
jO, jl, jn, yO. 


jO. jl. jn. yO. yl, 
abs. iabs. dabs. cabs. 


versions of an SCCS file.sccsdifT(l) 

vfont: font formats for the Benson-Varian or .... vfont(5) 
vfonti.nfo: inspect and print out information about . vfontinfo(l) 
vi: sc.-'cen oriented (visual) display editor based . . . vi(l) 

vice versa.expand(l) 

view graphs, and slides.mmt(l) 

view graphs.mv(7) 

viewing.more(l) 

(visual) display editor based on ex.vi(l) 

voicopy, labelit: copy file systems with label.volcopy(0) 

volume.fs(5) 

vp; Versatec printer-plotter...>^(4) 

vlrofl: trofi to the CANON L3P or the Versa tec V80. . ItrofT(l) 

w: who is on and what they are doing.w(0 

wait: await completion of process.wait(l) 

wait for child process to stop or terminate.wait(2) 

wait: wait for child process to stop or terminate. . . wait(2) 

walk d file tree.ftw(3C) 

wall: write to all users.wall(8) 

wc: word count.wc(l) 

what a command is.whati3(l) 

what device drivers are in an unix kernel.whatconf(0) 

what: identify SCCS files.what(l) 

what they are doing.w(l) 

what to do upon receipt of a signal.signal(2) 

what to do when the system crashes.. crash(8> 

whatconf: what device drivers are in an unix.whatconf(8) 

whatis: describe what a command is.whatis(l) 

whereis: locate source, binary, and or m-anual for . . whereis(l) 

who are on the system..users(l) 

who is doing what.whodo(8) 

who is my mail from?.from(l) 

who is on and what they are doing.w(l) 

who is on the system-.. who(l) 

who: who is on the system .who(l) 

whodo: who is doing what.whodo(8) 

width output device.fold(l) 

wordy sentences, interactive thesaurus for diction. . diction(l) 

working directory. . ..cd(l ) 

working directory.chdir(2) 

working directory.getcwd(3C) 

working directory name.P^<1( 1) 

write on a file.write(2) 

write password file entry...putpwent(3C) 

writ> to all users.wali(8) 

write to another user.write(l) 

write: write on a file.write(2) 

write: write to another user.. . write(l) 

writing.open(2) 

wtmp entry formats.utmp(5) 

wtmp: utmp and wtmp entry formats.utmp(5) 

wtmpflx: manipulate connect accounting records. . . fwtm'’!^) 
wump: the game of hunt-the-wumpus. ........ wump(6> 

xargs: construct argument list(s) and execute .... xargs(l) 

xd : hexadecimal dump.xd(l) 

xor. not, Ishift, rshift: Fortran bitwise boolean .... bool(3J^ 

xref; cross-reference listing.xref 

xstr: extract strings fromC programs to implement . xst ' 

yO, yl, yn: Bessel functions.be .>:)'3U) 

yl, yn: Bessel functions.besaci 3U) 

yacc: yet another compiler-compiler.• • • • 7*^ 

yes: be repetitively aflirmative.7*3(1) 

yn: Bessel functions.bes3el(3U) 

zabs: Fortran absolute value.abs(3f) 
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NAME 

a60 — MIT assembler 
SYNOPSIS 

a68 [—o objectfile] [—alu] sourcefile 

a68 file.s writes object 'file.o’, or the o objectfile’ 


a68 —a 

writes all symbols, not just globals, in ’file.o’. 

a68 -1 

writes a listing on stdout, e.g. 
a68 -1 file.s >file.lis 

a68 —u 

makes undefined symbols .extern, instead of errors. 

DESCRIPTION 



A68 is the MIT Trix assembler; see /usr/doc/a68. A68 is NOT compatible 
with AS(1): it has no macros, and wants e.g. ’movw’ instead of ’MOVE’ or 
’MOVE.W’. (There is a filter to change Motorola assembler format to A68, 
and another to expand macros). 

SEE ALSO 

/usr/doc/a68 

ii 
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NAME 

acctcom — search and print process accounting file(s) 

SYNOPSIS 

acctcom [ [ options ] [ file ] ] . . . 

DESCRIPTION 

Acctcom reOids file, the standard input, or /usr/adm/pacct, in the form 
described by accf(5) and writes selected records to the standard output. 
Each record represents the execution of one process. The output shows 
the COMMAND NAME. USER, TTYNAME, START TIME, END TIME. REAL (SEC), CPU 
(SEC), MEAN SIZE(K). and optionally. F (the fork/exec flag; 1 for fork 
without exec) and STAT (the system exit status). 

The command name is prepended with a # if it was executed with super- 
user privileges. If a process is not associated with a known terminal, a ? 
is printed in the TTYNAME field. 

If no files are specified, and if the standard input is associated with a ter¬ 
minal or /dev/nuU (as is the case when using & in the shell), 
/usr/adm/pacct is read, otherwise the standard input is read. 

If any file arguments are given, they are read in their respective order. 
Each file is normally read forward, i.e., in chronological order by process 
completion time. The file /usr/adm/pacct is usually the current file to 
be examined: a busy system may need several such files of which all but 
the current file are found in /usr/adm/pacct?. The options are: 

—b Read backwards, showing latest commands first. 

—f Print the fork/exec flag and system exit status columns in the 

output. 

—h Instead of mean memory size, show the fraction of total avail¬ 

able CPU time consumed by the process during its execution. 
This “hog factor" is computed as: 

(total CPU time)/(elapsed time). 

—i Print columns containing the I/O counts in the output. 

—k Instead of memory size, show total kcore-minutes. 

—m Show mean core size (the default). 

—r Show CPU factor (user time/(system-time + user-time). 

—t Show separate system and user CPU times. 

—V Exclude column headings from the output. 

—1 line Show only processes belonging to terminal /dev/fine. 

—u user Show only processes belonging to user that may be specified 

by: a user ID, a login name that is then converted to a user ID, 
a # which designates only those processes executed with 
super-user privileges, or ? which designates only those 
processes associated with unknown user IDs. 

—g group Show only processes belonging to group. The group may be 
designated by either the group ID or group name. 

—d mm/dd 

Any time arguments following this flag are assumed to occur 
on the given month mm and the day dd rather than during 
last 24 hours. This is needed for looking at old files. 

—s time Select processes existing at or after time, given in the format 

Ar [ :min [ -.sec ] ]. 
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— e time Select processes existing at or before time. 

— S time Select processes starting at or after time. 

—E time Select processes ending at or before time. 

—n pattern 

Show only commands matching pattern that may be a regular 
expression as in eci(l) except that + means one or more 
occurrences. 

— o ofile Copy selected process records in the input data format to 

ofile -, supress standard output printing. 

—H factor Show only processes that exceed factor, where factor is the 
"hog factor” as explained in option —h above. 

—O sec Show only processes with CPU system time exceeding sec 

seconds. 

—C sec Show only processes with total CPU time, system plus user, 

exceeding sec seconds. 

Listing options together has the effect of a logical and. 

FILES 

/etc/passwd 

/usr/adm/pacct 

/etc/group 

SEE ALSO 

ps(l), su(l), acct(2), acct(5), utmp(5). 

acct(8), acctcms(0), acctcon(8), acctmerg(8), acctprc(8), acctsh(8), 
fwtmp(8), runacct(8). 

BUGS 

Acctcom only reports on processes that have terminated: use J3s(l) for 
active processes. If time exceeds the present time and option —d is not 
used, then time is interpreted as occurring on the previous day. 
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NAME 

adb — debugger 
SYNOPSIS 

adb [—w] [ objfil [ corfil ] ] 

DESCRIPTION 

Adb is a general purpose debugging program. It may be used to examine 
files and to provide a controlled environment for the execution of UNIX 
programs. 

Objfil is normally an executable program file, preferably containing a 
symbol table; if not then the symbolic features of adb cannot be used 
although the file can still be examined. The default for objfil is a.out. 
Corfil is assumed to be a core image file produced after executing objfil-, 
the default for corfil is core. 

Requests to adb are read from the standard input and responses are to 
the standard output. If the —w flag is present then both objfil and corfil 
are created if necessary and opened for reading and writing so that files 
can be modified using ac£6. Adb ignores QUIT; INTERRUPT causes return 
to the next adb command. 

In general requests to adb are of the form 

[ address ] [, count ] [ command ] [; ] 

If address is present then dot is set to address. Initially dot is set to 0. 
For most commands count specifies how many times the command will be 
executed. The default count is 1. Address and count are expressions. 

The interpretation of an address depends on the context it is used in. If 
a subprocess is being debugged then addresses are interpreted in the 
usual way in the address space of the subprocess. For further details of 
address mapping see ADDRESSES. 

EXPRESSIONS 

The value of dot. 

+ The value of dot incremented by the current increment. 

^ The value of dot decremented by the current increment. 

" The last address typed. 
integer 

An octal number if integer begins with a 0; a hexadecimal number 
if preceded by #; otherwise a decimal number. 

integer.fraction 

A 32 bit floating point number. 

'cccc' The ASCII value of up to 4 characters. \ may be used to escape a 
< name 

The value of name, which is either a variable name or a register 
name. Adb maintains a number of variables (see VARIABLES) named 
by single letters or digits. If name is a register name then the 
value of the register is obtained from the system header in corfil. 
The register names are dO ... d7 aO ... a7 pc ns ac ip. The register 
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names ns, ac and ip deserve special explanation. The register ns is 
the concatenation of the 2 byte exception vector number plus the 
2 byte 68000 cpustate stored during bus or address error excep¬ 
tions. If e.g. the first two bytes of ns are 0002, the program was 
interrupted by a bus error (exception vector 2). The register ac 
contains the access address for a bus or address error exception. 
The register ip is the concatenation of the 2 byte instruction 
register, i.e. the first two bytes of the instruction that caused a 
bus or address error, and the 2 byte processor status. For excep¬ 
tions that are not bus or address error, the second half of ns, all 
of ac, and the first half of ip are 0. 

symbol 

A symbol is a sequence of upper or lower case letters, underscores 
or digits, not starting with a digit. The value of the symbol is 
taken from the symbol table in objfil. An initial _ or ~ will be 
prepended to symbol if needed. 

_ symbol 

In C, the 'true name’ of an external symbol begins with _. It may 
be necessary to utter this name to distinguish it from internal or 
hidden variables of a program. 

routine .name 

The address of the variable name in the specified C routine. Both 
routine and name are symbols. If name is omitted the value is the 
address of the most recently activated C stack frame correspond¬ 
ing to routine . 

(exp ) The value of the expression exp. 

Monadic operators 

*exp The contents of the location addressed by exp in corfil. 

@exp The contents of the location addressed by exp in objfil. 

-exp Integer negation. 
r^exp Bitwise complement. 

Dyadic operators are left associative and are less binding than monadic 
operators. 

ei+6.2 Integer addition. 

6 i —e2 Integer subtraction. 

6 i *62 Integer multiplication. 

6 1 %e2 Integer division. 

6 i&e2 Bitwise conjunction. 
ej|e2 Bitwise disjunction. 

el§e2 El rounded up to the next multiple of e2. 

COMMANDS 

Most commands consist of a verb followed by a modifier or list of 
modifiers. The following verbs are available. (The commands ’?' and '/' 
may be followed by see ADDRESSES for further details.) 
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?/ Locations starting at address in objfil are printed according to the 
format /. 

// Locations starting at address in corfil are printed according to the 
format/. 

=/ The value of address itself is printed in the styles indicated by the 
format /. (For i format *?' is printed for the parts of the instruction 
that reference subsequent words.) 

A format consists of one or more characters that specify a style of print¬ 
ing. Each format character may be preceded by a decimal integer that is 
a repeat count for the format character. While stepping through a for¬ 
mat dot is incremented temporarily by the amount given for each format 
Tetter. If no format is given then the last format is used. The format 
letters available are as follows. 


o 2 



0 

q 

Q 

d 

D 

X 

X 

u 

U 

f 


4 

2 

4 

2 

4 

2 

4 

2 

4 

4 


F 0 


b 1 
c 1 
C 1 



S n 


Y 4 
i n 


a 0 

/ 


Print 2 bytes in octal. All octal numbers output by adb are 
preceded by 0. 

Print 4 bytes in octal. 

Print in signed octal. 

Print long signed octal. 

Print in decimal. 

Print long decimal. 

Print 2 bytes in hexadecimal. 

Print 4 bytes in hexadecimal. 

Print as an unsigned decimal number. 

Print long unsigned decimal. 

Print the 32 bit value as a floating point number. Currently 
only FFP format supported (see/p(3)). 

Print double floating point. For FFP same as above, except 
larger printing format. 

Print the addressed byte in octal. 

Print the addressed character. 

Print the addressed character using the following escape 
convention. Character values 000 to 040 are printed as @ 
followed by the corresponding character in the range 0100 
to 0140. The character @ is printed as @®. 

Print the addressed characters until a zero character is 
reached. 

Print a string using the @ escape convention, n is the 
length of the string including its zero terminator. 

Print 4 bytes in date format (see cfime(3C)). 

Print as 68000 instructions, n is the number of bytes occu¬ 
pied by the instruction. This style of prin,ting causes vari¬ 
ables 1 and 2 to be set to the offset parts of the source and 
destination respectively. 

Print the value of dot in symbolic form. Symbols are 
checked to ensure that they have an appropriate type as 
indicated below. 

local or global data symbol 
local or global text symbol 
local or global absolute symbol 
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p 2 Print the addressed value in symbolic form using the same 
rules for symbol lookup as a. 

I 0 When preceded by an integer tabs to the next appropriate 
tab stop. For example, 8t moves to the next 8-space tab 
stop. 

r 0 Print a space, 

n 0 Print a newline. 

0 Print the enclosed string. 

Dot is decremented by the current increment. Nothing is 
printed. 

+ Dot is increniented by 1. Nothing is printed. 

— Dot is decremented by 1. Nothing is printed. 

newline 

If the previous command temporarily incremented dot, make the 
increment permanent. Repeat the previous command with a count 
of 1. 

[?/]l value mask 

Words starting at dot are masked with mask and compared with 
value until a match is found. If L is used then the match is for 4 
bytes at a time instead of 2. If no match is found then dot is 
unchanged: otherwise dot is set to the matched location. If mask 
is omitted then —1 is used. 

[?/]w value ... 

Write the 2-byte value into the addressed location. If the com¬ 
mand is W. write 4 bytes. Odd addresses are not allowed when writ¬ 
ing to the subprocess address space. 

[?/]m 6i el /i[?/] 

New values for {bl, el,fl) are recorded. If less than three expres¬ 
sions are given then the remaining map parameters are left 
unchanged. If the '?’ or '/' is followed by then the second seg¬ 
ment {b2,e2,f2) of the mapping is changed. If the list is ter¬ 
minated by ■?' or '/’ then the file {objfil or corfil respectively) is 
used for subsequent requests. (So that, for example, Vm?' will 
cause ■/' to refer to objfil.) 

>name 

Dot is assigned to the variable or register named. 

! A shell is called to read the rest of the line following ’!’. 

Smodifier 

Miscellaneous commands. The available modifiers are: 

</ Read commands from the file f and return. 

>/ Send output to the file /, which is created if it does not 
exist. 

r Print the general registers and the instruction addressed 
by pc. Dot is set to pc. 

b Print all breakpoints and their associated counts and com¬ 
mands. 

c C stack backtrace. If address is given then it is taken as 
the address of the current frame (instead of a6). If C is 
used then the names and (32 bit) values of all automatic 
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V 

e 

w 

s 

o 

• 

^ V 

m 

and static variables are printed for each active function. If 
count is given then only the first count frames are printed. 

If the module was compiled with the -L option of cc(l), the 
procedure name is followed by the current linenumber. For 
all variables 32 bits are printed, even if the variable is only 
char or short. In this case only the foremost bytes are to be 
considered. For register variables, however, the whole 
register in which the variable resides is printed, and so for 
shorts the last two bytes are the relevant ones! In order to 
help you make the distinction between register and normal 
variables, the latter are prefixed with a "<". 

The names and values of external variables are printed. 

. Set the page width for output to address (default 80). 

Set the limit for symbol matches to address (default 255). 

All integers input are regarded as octal. 

Reset integer input as described in EXPRESSIONS. 

Exit from adb. 

Print all non zero variables in octal. 

Print the address map. 


‘.modifier 

Manage a subprocess. Available modifiers are: 

be Set breakpoint at address. The breakpoint is executed 


d 

count—1 times before causing a stop. Each time the break¬ 
point is encountered the command c is executed. If this 
command sets dot to zero then the breakpoint causes a 
stop. If the module has been compiled with option -g, see 
cc(l), you can set a breakpoint at line 75 by saying L75;b. 

Delete breakpoint at address. 

r 

• 

Run objfiL as a subprocess. If address is given explicitly 
then the program is entered at this point; otherwise the 
program is entered at its standard entry point, count 
specifies how many breakpoints are to be ignored before 
stopping. Arguments to the subprocess may be supplied on 
the same line as the command. An argument starting with 
< or > causes the standard input or output to be esta¬ 
blished for the command. All signals are turned on on entry 
to the subprocess. 

cs 

The subprocess is continued with signal s, see signal{2). If 
address is given then the subprocess is continued at this 
address. If no signal is specified then the signal that caused 
the subprocess to stop is sent. Breakpoint skipping is the 
same as for r. 

ss 

As for c except that the subprocess is single stepped count 
times. If there is no current subprocess then objfil is run as 
a subprocess as for r. In this case no signal can be sent; 
the remainder of the line is treated as arguments to the 
subprocess. 

k 

The current subprocess, if any, is terminated. 
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VARIABLES 

Adb provides a number of variables. Named variables are set initially by 
adb but are not used subsequently. Numbered variables are reserved for 
communication as follows. 

0 The last value printed. 

1 The last offset part of an instruction source. 

2 The previous value of variable 1. 

On entry the following are set from the system header in the corfiL. If 
corfil does not appear to be a core file then these values are set from 
objfil. 

b The base address of the data segment, 

d The data segment size, 

e The entry point. 

m The ‘magic’ number (0405, 0407, 0410 or 0411). 
s The stack segment size, 

t The text segment size. 

ADDRESSES 

The address in a file associated with a written address is determined by a 
mapping associated with that file. Each mapping is represented by two 
triples (6i, el.fl) and (62, e2, f2) and the file address corresponding to a 
written address is calculated as follows. 

bl^address<el => file address=address +f 1—b 1, otherwise, 
b2^address <e2 => file address^address +f2—b2, 

otherwise, the requested address is not legal. In some cases (e.g. for pro¬ 
grams with separated I and D space) the two segments for a file may 
overlap. If a ? or / is followed by an • then only the second triple is used. 

The initial setting of both mappings is suitable for normal a.out and core 
files. If either file is not of the kind expected then, for that file, 6i is set 
to 0, ei is set to the maximum file size and fl is set to 0; in this way the 
whole file can be examined with no address translation. 

So that ad6 may be used on large files all appropriate values are kept as 
signed 32 bit integers. 

FILES 

/dev/mem 

/dev/swap 

a.out 

core 

SEE ALSO 

ptrace(2), a.out(5), core(5) 

DIAGNOSTICS 

'Adb' when there is no current command or format. Comments about 
inaccessible files, syntax errors, abnormal termination of commands, etc. 
Exit status is 0, unless last command failed or returned nonzero status. 

BUGS 

A breakpoint set at the entry point is not effective on initial entry to the 
program. 

When single stepping, system calls do not count as an executed 
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instruction. 

Local variables whose names are the same as an external variable may 
foul up the accessing of the external. 


EXAMPLES 

After a core dump: 


adb prog 

Sr 

Sc 

SC 

Se 

bufp/X 

•bufp/X 

write?! 

(cr) 

:b 

:r hello <inp 
main,-l?ia 
data/4X2d 
(cr) 

#100>d0 

<dl=X 

•(<a6+0)/XXX 

write?l #4e75 

;b 

:c 

:s 


(second parameter core is assumed) 

(print registers) 

(print C stack trace) 

(print full C stack trace) 

(print external variables) 

(print contents of bufp as long hex) 

(print 4 bytes hex where bufp points to) 

(prints first instruction, link a6....) 

(print next instruction) 

(set breakpoint at this instruction) 

(run prog with param hello and input from inp) 
(disassemble program starting at main) 

(print data: 4 long hex, 2 short decimal) 

(print next data in same format 
(write #100 to register dO) 

(print dl long hex) 

(print first three longs of parameter area) 
(search for rts instruction at end of proc write) 
(set breakpoint at this address) 

(continue program until stop or breakpoint) 
(single step through program 


etc. 

On the 68000, as opposed to the 68010 or 68020, the stack will not neces¬ 
sarily grow automatically. You can recognize a stackoverfiow with the fol¬ 
lowing commands: 

adb prog 

Sr 

8m 

If the value of register ac is less than the value b2 for the second (/) 
map, the stack overflowed. To get the needed stack size, type 
#f00000-<ac=D 

This will output the difference between the top of the stack and the 
access address in decimal. Round the value up some kbyte, and give the 
command 

stksiz prog <value> 
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NAME 

admin — create and administer SCCS files 


SYNOPSIS 

admin [—n] 

[—<iflag[fiag-val]] 
[—z] files 


[-i[name]] [-irel] [-t[name]] [-mag[fiag-val]] 
[ alogin] [—elogin] [—ni[mrlist]] [—y[comment]] [—h] 


DESCRIPTION 

AdtTTvin is used to create new SCCS files and change parameters of existing 
ones. Arguments to admin, which may appear in any order, consist of 
keyletter arguments, which begin with -, and named files (note that SCCS 
file names must begin with the characters s.). If a named file doesn’t 
exist, it is created, and its parameters are initialized according to the 
specified keyletter arguments. Parameters not initialized by a keyletter 
argument are assigned a default value. If a named file does exist, param¬ 
eters corresponding to specified keyletter arguments are changed, and 
other parameters are left as is. 

If a directory is named, admin behaves as though each file in the direc¬ 
tory were specified as a named file, except that non-SCCS files (last com¬ 
ponent of the path name does not begin with s.) and unreadable files are 
silently ignored. If a name of — is given, the standard input is read; each 
line of the standard input is taken to be the name of an SCCS file to be 
processed. Again, non-SCCS files and unreadable files are silently 
ignored. 


The keyletter arguments.are as follows. Each is explained as though only 
one named file is to be processed since the effects of the arguments 
apply independently to each named file. 

“n This keyletter indicates that a new SCCS file is to be 

created. 

—i[na7ne] The nomc of a file from which the text for a new SCCS 

file is to be taken. The text constitutes the first delta 
of the file (see —r keyletter for delta numbering 
scheme). If the i keyletter is used, but the file name is 
omitted, the text is obtained by reading the standard 
input until an end-of-file is encountered. If this 
keyletter is omitted, then the SCCS file is created 
empty. Only one SCCS file may be created by an admin 
command on which the i keyletter is supplied. Using a 
single admin to create two or more SCCS files require 
that they be created empty (no —i keyletter). Note 
that the —i keyletter implies the —n keyletter. 

rrei The release into which the initial delta is inserted. 

This keyletter may be used only if the -i keyletter is 
also used. If the —r keyletter is not used, the initial 
delta is inserted into release 1. The level of the initial 
delta is always 1 (by default initial deltas are named 
1 . 1 ). 

—t[name] The name of a file from which descriptive text for the 

SCCS file is to be taken. If the —t keyletter is used and 
admin is creating a new SCCS file (the —n and/or —i 
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keyletters also used), the descriptive text file name 
must also be supplied. In the case of existing SCCS 
files: (1) a —t keyletter without a file name causes 
removal of descriptive text (if any) currently in the 
SCCS file, and (2) a —t keyletter with a file name causes 
text (if any) in the named file to replace the descrip¬ 
tive text (if any) currently in the SCCS file. 

This keyletter specifies a flag, and, possibly, a value 
for the flag, to be placed in the SCCS file. Several f 
keyletters may be supplied on a single admin com¬ 
mand line. The allowable flags and their values are: 

b Allows use of the —b keyletter on a yef(l) command to 
create branch deltas. 

cceii The highest release (i.e., "ceiling”), a number less than 
or equal to 9999, which may be retrieved by a grei(l) 
command for editing. The default value for an 
unspecified c flag is 9999. 

tfloor The lowest release (i.e., "floor"), a number greater 
than 0 but less than 9999, which may be retrieved by a 
get{l) command for editing. The default value for an 
unspecified f flag is 1. 

dSlD The default delta number (SID) to be used by a get{l) 
command. 

i Causes the "No id keywords (ge6)" message issued by 
flref(l) or deLta{l) to be treated as a fatal error. In the 
absence of this flag, the message is only a warning. 
The message is issued if no SCCS identification key¬ 
words (see gfef(l)) are found in the text retrieved or 
stored in the SCCS file. 

j Allows concurrent get{l) commands for editing on the 
same SID of an SCCS file. This allows multiple con¬ 
current updates to the same version of the SCCS file. 

Hist A List of releases to which deltas can no longer be 
made (get —e against one of these "locked” releases 
fails). The list has the following syntax: 

<list> ::= <range> | <list> , <range> 

<range> ::= RELEASE NUMBER \ a 

The character a in the list is equivalent to specifying 
all releases for the named SCCS file. 

n Causes delta{l) to create a "null" delta in each of 
those releases (if any) being skipped when a delta is 
made in a new release (e.g., in making delta 5.1 after 
delta 2.7, releases 3 and 4 are skipped). These null 
deltas serve as "anchor points” so that branch deltas 
may later be created from them. The absence of this 
flag causes skipped releases to be non-existent in the 
SCCS file preventing branch deltas from being created 
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from them in the future. 

qfexf User definable text substituted for all occurrences of 
the %Q/5 keyword in SCCS file text retrieved by flref(l). 

xamod Module name of the SCCS file substituted for all 
occurrences of the keyword in SCCS file text 

retrieved by flrcf(l). If the m flag is not specified, the 
value assigned is the name of the SCCS file with the 
leading s. removed. 


tfype Type of module in the SCCS file substituted for all 
occurrences of %Y% keyword in SCCS file text retrieved 
byyef(l). 

v[pym] 

Causes deffa(l) to prompt for Modification Request 
{MR) numbers as the reason for creating a delta. The 
optional value specifies the name of an MR number 
validity checking program (see deZfa(l)). (If this flag 
is set when creating an SCCS file, the m keyletter must 
also be used even if its value is null). 

—dflag Causes removal (deletion) of the specified flag from an 

SCCS file. The —d keyletter may be specified only when 
processing existing SCCS files. Several —d keyletters 
may be supplied on a single admin command. See the 
—f keyletter for allowable/lap names. 

Uist A list of releases to be "unlocked". See the —f 
keyletter for a description of the 1 flag and the syntax 
of a List. 


—alogin A login name, or numerical UNIX group ID, to be added 

to the list of users which may make deltas (changes) 
to the SCCS file. A group ID is equivalent to specifying 
all login names common to that group ID. Several a 
keyletters may be used on a single admin command 
line. As many logins, or numerical group IDs, as 
desired may be on the list simultaneously. If the list of 
users is empty, then anyone may add deltas. 

—elogin A login name, or numerical group ID, to be erased from 

the list of users allowed to make deltas (changes) to 
the SCCS file. Specifying a group ID is equivalent to 
specifying all login names common to that group ID. 
Several e keyletters may be used on a single admin 
command line. 

—y[com7nenf] The comment text is inserted into the SCCS file as a 
comment for the initial delta in a manner identical to 
that of delta{l). Omission of the —y keyletter results 
in a default comment line being inserted in the form: 

date and time created YY/ MM/DD HH:MM:SS by login 

The —y keyletter is valid only if the —i and/or —n 
keyletters are specified (i.e., a new SCCS file is being 
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created). 

-Tnimrlist] The list of Modification Requests {MR) numbers is 
inserted into the SCCS file as the reason for creating 
the initial delta in a manner identical to deffa(l). The 
V fiag must be set and the MR numbers are validated if 
the V fiag has a value (the name of an MR number vali¬ 
dation program). Diagnostics will occur if the v fiag is 
not set or A/i? validation fails. 

Causes admin to check the structure of the SCCS file 
(see sccsfile{5)), and to compare a newly computed 
check-sum (the sum of all the characters in the SCCS 
file except those in the first line) with the check-sum 
that is stored in the first line of the SCCS file. 
Appropriate error diagnostics are produced. 

This keyletter inhibits writing on the file, so that it 
nullifies the effect of any other keyletters supplied, 
and is, therefore, only meaningful when processing 
existing files. 

The sees file check-sum is recomputed and stored in 
the first line of the SCCS file (see —h, above). 

Note that use of this keyletter on a truly corrupted file 
may prevent future detection of the corruption. 

FILES 

The last component of all SCCS file names must be of the form 
name. New SCCS files are given mode 444 (see ch,mod{l)). Write permis¬ 
sion in the pertinent directory is, of course, required to create a file. All 
writing done by admin is to a temporary x-file, called x.file-name, (see 
^ef(l)), created with mode 444 if the admin command is creating a new 
SCCS file, or with the same mode as the SCCS file if it exists. After suc¬ 
cessful execution of admin, the SCCS file is removed (if it exists), and the 
x-file is renamed with the name of the SCCS file. This ensures that 
changes are made to the SCCS file only if no errors occurred. 

It is recommended that directories containing SCCS files be mode 755 and 
that SCCS files themselves be mode 444. The mode of the directories 
allows only the owner to modify SCCS files contained in the directories. 
The mode of the SCCS files prevents any modification at all except by 
sees commands. 

If it should be necessary to patch an SCCS file for any reason, the mode 
may be changed to 644 by the owner allowing use of ed(l). Care must be 
taken! The edited file should always be processed by an admin —h to 
check for corruption followed by an admin —z to generate a proper 
check-sum. Another admin —h is recommended to ensure the SCCS file is 
valid. 

Admin also makes use of a transient lock file (called z.file-name), which 
is used to prevent simultaneous updates to the SCCS file by different 
users. See get{l) for further information. 

SEE ALSO 

delta(l), ed(l). get(l), help(l). prs(l), what(l), sccsfile(5). 
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Source Code Control System User's Guide by L. E. Bonanni and C. A. 
Salemi. 

DIAGNOSTICS 

Use help{l) for explanations. 
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NAME ^ 

apropos — locate commands by keyword lookup 

SYNOPSIS 

apropos ke)rword ... 

DESCRIPTION 

Apropos shows which manual sections contain instances of any of the 
given keywords in their title. Each word is considered separately and 
case of letters is ignored. Words which are part of other words are con¬ 
sidered thus looking for compile will hit all instances of ‘compiler’ also. 
Try 

apropos password 

and 

apropos editor 

If the line starts ■name(section) ...’ you can do ‘man section name’ to get 
the documentation for it. Try ‘apropos format’ and then ‘man 3s printf 
to get the manual on the subroutine prinf/. 

Apropos is actually just the —k option to the 7non(l) command. 

FILES 

/usr/lib/whatis data base 

SEE ALSO 

man(l). whatis(l), catman(8) 

AtJTHOR 

William Joy 
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NAME 

ar — archive and library maintainer 

SYNOPSIS 

ar key [ posname ] afile name ... 

DESCRIPTION 

Ar maintains groups of files combined into a single archive file. Its main 
use is to create and update library files as used by the link editor. It can 
be used, though, for any similar purpose. 

Key is one character from the set drqtpmx, optionally concatenated with 
one or more of vuaibcl. Afile is the archive file. The names are consti¬ 
tuent files in the archive file. The meanings of the key characters are: 

d Delete the named files from the archive file. 

r Replace the named files in the archive file. If the optional charac¬ 
ter u is used with r, then only those files with modified dates later 
than the archive files are replaced. If an optional positioning 
character from the set abi is used, then the posname argument 
must be present and specifies that new files are to be placed after 
(a) or before (b or i) posname. Otherwise new files are placed at 
the end. 

q Quickly append the named files to the end of the archive file. 
Optional positioning characters are invalid. The command does 
not check whether the added members are already in the archive. 
Useful only to avoid quadratic behavior when creating a large 
archive piece-by-piece. 

t • Print a table of contents of the archive file. If no names are given, 
all files in the archive are tabled. If names are given, only those 
files are tabled. 

p Print the named files in the archive. 

m Move the named files to the end of the archive. If a positioning 
character is present, then the posname argument must be present 
and, as in r, specifies where the files are to be moved. 

X Extract the named files. If no names are given, all files in the 
archive are extracted. In neither case does x alter the archive 
file. 

V Verbose. Under the verbose option, ar gives a file-by-file descrip¬ 
tion of the making of a new archive file from the old archive and 
the constituent files. When used with t, it gives a long listing of all 
information about the files. When used with x, it precedes each 
file with a name. 

c Create. Normally ar will create afile when it needs to. The create 
option suppresses the normal message that is produced when afile 
is created. 

1 Local. Normally ar places its temporary files in the directory 

/tmp. This option causes them to be placed in the local directory. 

FILES 

/tmp/v* temporaries 
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SEE ALSO 

ranlib(l), ld(l), lorder(l), ar(5). 


BUGS 

If the same file is mentioned twice in an argument list, it may be put 
the archive twice. 


in 
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NAME 

as — assembler 

SYNOPSIS 

as file ... 

DESCRIPTION 

i4s assembles the named files, which must have the suffix ’.s’. The output 
of the assembly is left on the corresponding files with suffix ’.o’. Assem¬ 
bler listings are produced on the corresponding files with suffix ’.1st’. 


FILES 


/lib/cpp 

/lib/asm 

/usr/tmp/asm* 

/lib/symfile 

name.s 

name.o 

name.1st 


C preprocessor 
assembler 
temporary files 

used for initialization of /lib/asm 
assembler source 
assembled module 
assembler listing 


SEE ALSO 

Ulrike Weng-Beckmann, Assembfer 68000 Users Guide 
Motorola, Macro Assembler Reference Manual 

DIAGNOSTICS 

Diagnostics are given in the assembler listing. 
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NAME 

at — execute commands at a later time 
SYNOPSIS 

at time [ day ] [ file ] 

DESCRIPTION 

At squirrels away a copy of the named/fie (standard input default) to be 
used as input to sA(l) at a specified later time. A cd(l) command to the 
current directory is inserted at the beginning, followed by assignments 
to all environment variables. When the script is run. it uses the user and 
group ID of the creator of the copy file. 

The time is 1 to 4 digits, with an optional following ‘A’. *P’, 'N' or ’M’ for 
AM, PM, noon or midnight. One and two digit numbers are taken to be 
hours, three and four digits to be hours and minutes. If no letters follow 
the digits, a 24 hour clock time is understood. 

The optional day is either (l) a month name followed by a day number, or 
(2) a day of the week; if the word 'week’ follows invocation is moved seven 
days further off. Names of months and days may be recognizably trun¬ 
cated. Examples of legitimate commands are 

at Bam jan 24 
at 1530 fr week 

At programs are executed by periodic execution of the command 
/usr/lib/atrun from cron{B). The granularity of at depends upon how 
often atrun is executed. 

Standard output or error output is lost unless redirected. 

FILES 

/usr/spool/at/yy.ddd.hhhh.uu 

activity to be performed at hour hhhh of year day ddd of year yy. uu is a 
unique number. 

/usr/spool/at/lasttimedone contains hhhh for last hour of activity, 
/usr/spool/at/past directory of activities now in progress 
/usr/lib/atrun program that executes activities that are due 
pwd(l) 

SEE ALSO 

calendar(l), cron(8) 

DIAGNOSTICS 

Complains about various syntax errors and times out of range. 

BUGS 

Due to the granularity of the execution of /usr/lib/atrun, there may be 
bugs in scheduling things almost exactly 24 hours into the future. 
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NAME 

awk — pattern scanning and processing language 
SYNOPSIS 

awk [ —Fc ] [ prog ] [ file ] ... 

DESCRIPTION 

Awk scans each input file for lines that match any of a set of patterns 
specified in prog. With each pattern in pro^r there can be an associated 
action that will be performed when a line of a file matches the pattern. 
The set of patterns may appear literally as prog, or in a file specified as 
-f file. 

Files are read in order; if there are no files, the standard input is read. 
The file name ’ means the standard input. Each line is matched against 
the pattern portion of every pattern-action statement; the associated 
action is performed for each matched pattern. 

An input line is made up of fields separated by white space. (This default 
can be changed by using FS, vide infra.) The fields are denoted SI, S2. ... 

; SO refers to the entire line. 

A pattern-action statement has the form 
pattern ( action } 

A missing { action } means print the line; a missing pattern always 
matches. 

An action is a sequence of statements. A statement can be one of the fol¬ 
lowing: 

if ( conditional ) statement [ else statement ] 
while ( conditional ) statement 

for ( expression ; conditional ; expression ) statement 

break 

continue 

( [ statement ] ... j 

variable = expression 

print [ expression-list ] [ >expression ] 

printf format [ , expression-list ] [ >expression ] 

next # skip remaining patterns on this input line 

exit § skip the rest of the input 

Statements are terminated by semicolons, newlines or right braces. An 
empty expression-list stands for the whole line. Expressions take on 
string or numeric values as appropriate, and are built using the opera¬ 
tors +, -, *, /, %, and concatenation (indicated by a blank). The C opera¬ 
tors +-h, —, +=, —=, •=, /=, and %= are also available in expressions. 
Variables may be scalars, array elements (denoted x[i]) or fields. Vari¬ 
ables are initialized to the null string. Array subscripts may be any 
string, not necessarily numeric; this allows for a form of associative 
memory. String constants are quoted 

The print statement prints its arguments on the standard output (or on 
a file if >file is present), separated by the current output field separator, 
and terminated by the output record separator. The printf statement 
formats its expression list according to the format {see printf {3S)). 
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The built-in function length returns the length of its argument taken as 
a string, or of the whole line if no argument. There are also built-in func¬ 
tions exjp, log, sqrt, and int. The last truncates its argument to an 
integer. substr(s, m, n) returns the n-character substring of s that 
begins at position m. The function sprintf(fmt, expr, expr, ...) formats 
the expressions according to the printf{3S) format given by fmt and 
returns the resulting string. 

Patterns are arbitrary Boolean combinations (!, ||. and parentheses) 
of regular expressions and relational expressions. Regular expressions 
must be surrounded by slashes and are as in egrep. Isolated regular 
expressions in a pattern apply to the entire line. Regular expressions 
may also occur in relational expressions. 

A pattern may consist of two patterns separated by a comma; in this 
case, the action is performed for all lines between an occurrence of the 
first pattern and the next occurrence of the second. 

A relational expression is one of the following; 

expression matchop regular-expression 
expression relop expression 

where a relop is any of the six relational operators in C, and a matchop is 
either ~ (for contains) or !~ (for does not contain). A conditional is an 
arithmetic expression, a relational expression, or a Boolean combination 
of these. 

The special patterns BEGIN and END may be used to capture control 
before the first input line is read and after the last. BEGIN must be the 
first pattern, END the last. 

A single character c may be used to separate the fields by starting the 
program with 

BEGIN ( FS = "c" j 

or by using the —Fc option. 

Other variable names with special meanings include NF, the number of 
fields in the current record; NR, the ordinal number of the current 
record; FILENAME, the name of the current input file; OFS, the output 
field separator (default blank); ORS, the output record separator (default 
newline); and OFMT, the output format for numbers (default ''%.6g"). 

EXAMPLES 

Print lines longer than 72 characters: 
length > 72 

Print first two fields in opposite order: 

I print S2, Si j 

Add up first column, print sum and average: 

( s += $1 { 

END I print "sum is", s. " average is", s/NR { 

Print fields in reverse order: 

\ for (i = NF; i > 0; —i) print Si j 
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Print all lines between start/stop pairs: 

/start/, /stop/ 

Print all lines whose first field is different from previous one: 

$1 != prev { print; prev = Si j 

SEE ALSO 

lex( 1), sed(l) 

A. V. Aho, B. W. Kernighan, P. J. Weinberger, Awk — a pattern scanning and 
processing language 

BUGS 

There are no explicit conversions between numbers and strings. To force 
an expression to be treated as a number add 0 to it; to force it to be 
treated as a string concatenate to it. 

REMARK 

Awk exists on the CADMUS in 4 different versions; awk.long, awk.ffp. 
awk.mot, awk.nsc. The program awk is linked to awk.ffp. Awk.long is a 
version without floating point, which keeps all variables as long integers. 
The other 3 awks are compiled with the 3 different floating point versions 
(see /p(3)). Awk.nsc will of course only work if your machine is equipped 
with an FPP board. 
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NAME 


basename — strip filename affixes 
SYNOPSIS 

basename string [ suffix ] 

DESCRIPTION 

Basename deletes any prefix ending in V and the suffix, if present in 
string, from string, and prints the result on the standard output. It is 
normally used inside substitution marks '' in shell procedures. 

This shell procedure invoked with the argument /usr/src/cmd/cat.c 
compiles the named file and moves the output to cat in the current 
directory: 


cc Si 

mv a.out 'basename 81 .c' 



SEE ALSO 


sh(l) 



/ 
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NAME 

basic — Basic Interpreter 
SYNOPSYS 

basic [ -anrsxtp ] [ +n ] [ file ] [ plotfile ] [ args ... ] 

DESCRIPTION 

Basic is an ANSI compatible Basic interpreter that runs under UNIX. It is 
written in C so it might not be quite as fast as other Bisic interpreters. 

The following options are available: 

—a abort (via lOT trap) on any error. Not for general use. 

—n requires that variable names follow the ANSI standard of a letter 

followed by an optional digit. 

—p (not yet supported) specifies the default plot output file or filter 

to be used for hgr and hplot commands. 

—r causes the file specified to be run. If +n is specified then execu¬ 

tion will start at line n . Basic vrill exit upon completion of the 
program. 

—t is a debugging option that traces the operation of the interpreter. 

—X is a debugging option that supresses the normal buffering of out¬ 
put. 

file is an optional file name that specifies a program that is to be read 
(or run if -r was specified) before control is passed to the user. 

args is an option list of arguments that are passed to the program via 
the argS function. The program may then use the argument 
strings as it sees fit. 

BASIC COMUANDS 

The following commands are available to control the running of a Basic 
program or interact with the system: 

•command causes the UNIX command "command" to be executed, and 
control to be returned back to Basic. 

AUTO [lineline2\ causes the program to enter into automatic line 
numbering mode. Line numbering starts at linel and increments by 
lines for each line entered. Automatic numbering mode is terminated by 
a null line, an attention interrupt, or by any error. A star will be 
printed if an automatically numbered line already exists in the program. 
To delete such a line enter a line with at least one space. 

BYE causes Basic to exit. 

CATALOG grxnls out the users cuirent file catalog (equivalent to Us ). 

CLEAR equivalent to CLEAR plus CLEAR STACK. This is also done 

automatically as part of the RUN command. 

CLEAR VARS clears the variable symbol table. 
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CLEAR STACKcXeBira the execution stack. This is necessary after a "stack 
overflow" error, if Basic statements (such as "print i"), are to be used. 

DEL [fine J],[fin.e2] deletes Uriel thru fine,? inclusive. It is also possible to 
delete a line by just specifying its line number. 

DUMP displays the contents of the symbol table. This is mainly for 
debugging Basic itself. 

EDIT causes the program in memory to be written out into a scratch file 
and the file editor (SEDITOR shell variable) invoked upon it. Any changes 
made to the program will be reflected in the memory version upon leav¬ 
ing the editor. 

HELP gives you some assistance. If you want more help use man basic. 

LIST [linel],[Une2] causes the program to be listed from lines linel thru 
lines . The default range is the entire program. 

LOAD is the same as the OLD command. 

MERGE [/ifc] causes the program in file to be merged with the current 
program in memory. Existing lines will be replaced when duplicate line 
numbers are found. 

MODE[INT\[FP\[UNDC\[IBMi\ changes the prompting sequence. 

OLD L/ffe] causes the current program to be discarded, and a new pro¬ 
gram read in from file . Execution may then be begun via the RUN com¬ 
mand. Note that all previous variable names are cleared. 

RENUMBER [line Inline2] causes the program in memory to be renum¬ 
bered, starting at linel , with an increment of lineS . linel defaults to 
10, and lines to 10. 

RUN [fine] causes the program to start execution. If fine is specified 
then execution starts at that line number. 

SAVE [file] causes the program in memory to be saved in file . file 
defaults to the last name mentioned in a OLD or command. 

SCR erases the program and then clears the symbol table. 

mirO/F disables TIMEON. 

TIMEON prints time spent in command. 

UNSAVE [file] deletes (unlinks, removes) a file saved via the SAVE com¬ 
mand. 
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BASIC STATEMENTS 

The following Basic statements may be issued from a stored program or 
as a statement typed in immediate execution mode. 

ASK is the same as the INPUT statement. 

CHAIN file [.fine] replace the current program with the program in the 
file file, and start execution at line Line if present, otherwise at the first 
line of the program. Note that the file must either be a string expression 
or a string constant. 

CLOSE #n closes unit n. It is quite legal to close a unit that has not been 
opened. When a program begins execution unit 0 is opened for input on 
standard input, and unit 1 is opened for output on standard output. 

DATA constant-list consists of one or more constants separated by com¬ 
mas. Blanks or tabs are not modified in DATA statements. 

DEF FN var(args) = expr causes a function (FN var) to be defined, with 
the given dummy arguments. When FN var(...) appears in an expression 
later the dummy arguments will have real values assigned to them and 
the value of the expression will be returned. 

DIM var (bounds),... each of the variables specified is dimensioned with the 
bounds provided. Basic, as currently configured allows up to two dimen¬ 
sions for each vector variable. Note that a dimensioned variable is dis¬ 
tinct from the scalar variable with the same name (e.g. "a" and ''a(i)" are 
different, for all values of "i"). 

END causes the program to terminate. Some Basic's require that END 
only appear on the last line of a program. 

FOP var = exprl TO exprS [ STEP exprS ] the variable specified is 
assigned the value of exprl, the values of exprS and exprS (if specified) 
are evaluated and saved. The following statements up to the matching 
next are executed until the value of var is greater than exprS. When the 
next statement is executed the value exprS is added to var. exprS 
defaults to 1, and may be negative, in which case the FOP terminates 
when var is less then exprS. 

GET is reserved for future expansion, and will allow input of binary files. 

GOSUB line cause execution to transfer to the line number specified. 
When a PETUPN is executed control will continue from the next state¬ 
ment after the GOSUB. 

GOTO line causes execution to transfer to the line number specified. 

IF expr THEN statement If the expression expr is TPUE (non-zero) then 
statement will be executed. Some Basic's only allow a statement number 
or a GOTO statement, but here any legal Basic statement is allowed, 
including another /F statement. Other variations of the /P statement are 
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supported, where THEN is optional, and statement is a line number. 

INPUT [)|fn,] [string,] var,... the variable (or variables) specified are read 
from the specified unit. If no unit is specified, unit 0 is used. If the 
string is specified it will be used as a prompt, as if printed via a PRINT 
statement. 

LET var=expr assigns the value of expr to the variable var. Note that the 
LET is optional, but should be specified for compatibility with other 
Basics. 

NEXT [var] terminates the preceeding FOR statement. The value of the 
for variable is incremented and if not greater than the limit the execu¬ 
tion continues at the statement following the FOi? statement. 

NOTRACE disables the tracing started by the TTZACiTstatement. 

ON expr GOSUB Line,... the value of expr is taken as an index into the list 
of line numbers and transfer is made to the n’th line number specified. 
Upon execution of a RETURN statement control will continue from the 
following statement. 

ON expr GOTO line,... the value of expr is taken as an index into the list of 
line numbers and transfer is made to the n’th line number specified. 

OPEN file FOR [INPUT/OUTPUT/APPEND] # n opens the file file for either 
input or output on unit n. file may be any string expression. The input 
statement reads (by default) from unit 0, the print statement writes by 
default to unit 1. APPEND is the same as OUTPUT, but writes at the end 
of the file. 

PRINT [#n.,] expr[,][;]... the value of the expression is printed on the 
specified unit. If no unit is specified then unit 1 is used. It may be either 
a number or a character string. If the comma is specified as a delimiter 
the values will be aligned in fields 16 colunms wide. If a semi-colon is 
used there will be no spacing between fields. If there is no delimiter the 
last value will be followed by a new line. A print statement by itself will 
issue a new line. 

PRINT [^n,] USING fmt; eayr[*][»]-” the value of the expression is printed 
in the same fashion as the PRINT siatement, except that the arithmetic 
expression is written according to the format specification fmt. See the 
section PRINT USING FORMAT SPECIFICATIONS . 

RANDOMIZE initializes the random number generator using the internal 
clock. 

READ var,... will read values (from following DATA statements) into the 
variables given. An error will occur if there are insufficient values on 
DATA statements. 

REM causes the following characters to be taken as a remark or 
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comment. Note that the same effect may be obtained by starting a line 
with either a single or double quote. 

RESTORE causes the next READ statement to start at the first DATA 
statement in the program. 

RETURN causes control to be transfered to the statement following the 
last GOSUB or ON expr GOSUB statement. If there is no enclosing GOSUB 
an error will occur. 

STOP causes the program to terminate with an appropriate comment. 

TRACE causes the line number of each statement to be printed as it is 
executed. This is sometimes helpful in following the execution of a pro¬ 
gram that is not behaving properly. 

VARIABLES 

In ANSI Basic, a variable must start with a letter, and may have an 
optional digit following. In UNIX Basic although only the first two charac¬ 
ters of a variable name are considered significant, an arbitrarily long 
name may be used. The second character does not have to be a digit. 

Following the name either a % (percent) or S (dollar) signs may be 
present. The percent sign indicates that the variable is to hold only 
integer values, while the dollar sign indicates that the variable is to hold 
string values. If neither is present then the variable will hold real (float¬ 
ing point) values. 

FUNCTIONS 

The following standard functions are provided: those marked with an 
asterisk (*) are not ANSI Basic and are a local implementation to facili¬ 
tate communication with the UNIX operating system. 

ABS(value) returns the absolute value of the given value. 

ARGS(n) • returns the n'th argument specified when Basic was opened. 
Argument zero is the name of the program file (if any). A null string will 
be returned if an argument is requested that was not specified. This is 
mostly useful when the —r switch is used to run a previously stored pro¬ 
gram. 

ATN(value) returns the arc-tangent (in radians) function of the given 
value. 

CHRS(n) returns the ASCII character that corresponds to n. n should 
normally be an integer in the range 0 <= n <= 127. Values in the range 
128 <= n <= 255 are possible. All other values are taken modulo 256. 

COS(angLe) returns the cosine function of the given angle in radians. 

DATESO * returns the current date in the format yy/mm/dd. 
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EXP(valxie) returns the natural exponent of the given value. 

INT(vaLue) returns the integer value of the given value. 

LEFTS (string,Length) the first length characters of the string are 
returned. It is an error if there are not length characters in string. 

LOG(value) returns the natural log of the given value. 

MIDS(string,start,length) the middle length characters of the string 
starting at offset start (1 = first character) are returned. It is an error if 
there are not length characters in string after start. 

UNDO returns a random number between 0.0 and 1.0. 

RIGHTS (string,length) the last length characters of the string are 
returned. It is an error if there are not length characters in string. 

SIN(angle) returns the sine function of the given angle in radians. 

SQR(value) returns the square root of the given value. 

STRS(value) returns a string corresponding to the value. 

SYS(n) * executes system function '’n", as follows: 

1 turn off input echoing 

2 turn on input echoing 

3 get one character from keyboard 

' 4 print symbol table 

5 not implemented 

6 not implemented 

7 exit from Basic interpreter 

SYSTEM (string) * executes string as a system (UNIX) command, and 
returns its exit status. Zero means the command terminated properly. 

TAN(angle) returns the tangent function of the given angle in radians. 

TIMES() returns the current time in hh:mm:ss format. 

VAL(string) returns a value corresponding to the string. 

OPERATORS 

The following operators are available: 

+ adds two numeric operands together, concatenates two strings, 
subtraction. 
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* multiplication 

/ division 

^ exponentiation 

<> not equal comparison 

= equal comparison, also assignment operator 

< less than comparison 

> greater than comparison 

<= less than or equal comparison 

>= greater than or equal comparison 

AND logical AND of two comparisons 

OR logical OR of two comparisons 

PRINT USING FORMAT SPECIFICATIONS 


The PRINT USING statement format has the following general format 
(where [ and ] enclose optional features): 

[+][**][XX]###[.]###[.]###.##[+] 


The characters have the following meanings 
# indicates that a digit may be placed here. 


indicates a decimal point 

+ indicates a sign may be placed before (or after) the number. 

•* causes leading zero’s to be replaced with asterisk fill, normally 
blanks are used. 

SS causes a dollar sign to be placed at the start of the number. 

, a comma is inserted into the number if any digits have been 

printed. Unlike some Bisic’s the position of the commas is 
significant. 


FILES 


/bin/ed 

/tmp/Ba* 


default editor 

for the editor temporary file. 


BUGS 


The following features are not implemented: 


HAT operations. 

The "PRINT USING" implements only a minimal subset of the nor¬ 
mal facilities. 
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NAME 

be — arbitrary-precision arithmetic language 
SYNOPSIS 

be [ -c ] [ -1 ] [ file ... ] 

DESCRIPTION 

Be is an interactive processor for a language which resembles C but pro¬ 
vides unlimited precision arithmetic. It takes input from any files given, 
then reads the standard input. The —1 argument stands for the name of 
an arbitrary precision math library. The syntax for 6c programs is as fol¬ 
lows; L means letter a-z, E means expression, S means statement. 

Comments 

are enclosed in /• and •/. 

Names 

simple variables: L 
array elements: L [ E ] 

The words ‘ibase’, 'obase', and ‘scale’ 

Other operands 

arbitrarily long numbers with optional sign and decimal point. 

(E) 

sqrt(E ) 

length ( E ) number of significant decimal digits 
scale ( E ) number of digits right of decimal point 
L(E.E) 

Operators 

+ — */%-(% is remainder: ^ is power) 

+ + — (prefix and postfix; apply to names) 

= =<=>=!=<> ^ 

Statements 

E 

( S : ... : S j 

if(E)S 

while ( E ) S 

for ( E ; E : E ) S 

null statement 

break 

quit 

Function definitions 

define L ( L.L ) ( 

auto L, ... , L 
S; ... S 
return ( E ) 

i 

Functions in —1 math library 
s(x) sine 
c(x) cosine 
e(x) exponential 
l(x) log 
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a(x) arctangent 
j(n,x) Bessel function 

All function arguments are passed by value. 

The value of a statement that is an expression is printed unless the main 
operator is an assignment. Either semicolons or newlines may separate 
statements. Assignment to scale influences the number of digits to be 
retained on arithmetic operations in the manner of dc(l). Assignments 
to ibase or abase set the input and output number radix respectively. 

The same letter may be used as an array, a function, and a simple vari¬ 
able simultaneously. All variables are global to the program. ‘Auto’ vari¬ 
ables are pushed down during function calls. When using arrays as func¬ 
tion arguments or deflning them as automatic variables empty square 
brackets must follow the array name. 

For example 

scale = 20 
define e(x)( 

auto a, b, c, i, s 
a = 1 
b = 1 
s = 1 

for(i=l; 1 = = 1; i-H+)| 
a = a*x 
b = b*i 
c = a/b 

if(c == 0) return(s) 
s = s+c 

I 

i 

defines a function to compute an approximate value of the exponential 
function and 

for(i=l: i<=10; i++) e(i) 

prints approximate values of the exponential function of the first ten 
integers. 

Be is actually a preprocessor for dc(l), which it invokes automatically, 
unless the —c (compile only) option is present. In this case the dc input 
is sent to the standard output instead. 

FILES 

/usr/lib/lib.b mathematical library 
dc(l) desk calculator proper 

SEE ALSO 

dc(l) 

L. L. Cherry and R. Morris, BC — An arbitrary precision desk-calculator 
language 

BUGS 

No &<5c, II, or ! operators. 

For statement must have all three E’s. 

Qu.it is interpreted when read, not when executed. 





BDIFF(l) 


MUNIX 


BDIFF( 1) 


NAME 

bdifT — big diff 
SYNOPSIS 

bdifT filel file2 [n] [-s] 

DESCRIPTION 

Bdiff is used in a manner analogous to to find which lines must be 

changed in two files to bring them into agreement. Its purpose is to allow 
processing of files which are too large for diff. Bdiff ignores lines com¬ 
mon to the beginning of both files, splits the remainder of each file into 
n-line segments, and invokes diff upon corresponding segments. The 
value of n is 3500 by default. If the optional third argument is given, and 
it is numeric, it is used as the value for n. This is useful in those cases in 
which 3500-line segments are too large for diff, causing it to fail. If filel 
(JiLe2) is —, the standard input is read. The optional —s (silent) argument 
specifies that no diagnostics are to be printed by bdiff (note, however, 
that this does not suppress possible exclamations by diff. If both 
optional arguments are specified, they must appear in the order indi¬ 
cated above. 

The output of bdiff is exactly that of diff, with line numbers adjusted to 
account for the segmenting of the files (that is, to make it look as if the 
files had been processed whole). Note that because of the segmenting of 
the files, bdiff does not necessarily find a smallest sufficient set of file 
differences. 

FILES 

/tmp/bd????? 

SEE ALSO 

difl(l). 

DIAGNOSTICS 

Use help{\) for explanations. 
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NAME 

bfs — big file scanner 

SYNOPSIS 

bfs [ — ] name 

DESCRIPTION 

Bfs is (almost) like eci(l) except that it is read-only and processes much 
larger files. Files can be up to 1024K bytes (the maximum possible size) 
and 32K lines, with up to 255 characters per line. Bfs is usually more 
efficient than ed for scanning a file, since the file is not’ copied to a 
buffer. It is most useful for identifying sections of a large file where 
csplit{l) can be used to divide it into more manageable pieces for edit¬ 
ing. 

Normally, the size of the file being scanned is printed, as is the size of 
any file written with the w command. The optional — suppresses printing 
of sizes. Input is prompted with • if P and a carriage return are typed as 
in ed. Prompting can be turned off again by inputting another P and car¬ 
riage return. Note that messages are given in response to errors if 
prompting is turned on. 

All address expressions described under ed are supported. In addition, 
regular expressions may be surrounded with two symbols besides / and ?: 
> indicates downward search without wrap-around, and < indicates 
upward search without wrap-around. Since bfs uses a different regular 
expression-matching routine from ed, the regular expressions accepted 
are slightly wider in scope (see regex{3X)). There is a slight difference in 
mark names; only the letters a through z may be used, and all 26 marks 
are remembered. 

The e. g, v, k. n, p, q, w. =, ! and null commands operate as described 

under ed. Commands such as -, +++—. +-l"l-=. —12, and •+4p are 

accepted. Note that l.lOp and 1,10 will both print the first ten lines. The 
f command only prints the name of the file being scanned; there is no 
remembered file name. The w command is independent of output diver¬ 
sion, truncation, or crunching (see the xo. xt and xc commands, below). 
The following additional commands are available: 

xf file 

Further commands are taken from the named file. When an 
end-of-file is reached, an interrupt signal is received or an 
error occurs, reading resumes with the file containing the xf. Xf 
commands may be nested to a depth of 10. 

xo [file ] 

Further output from the p and null commands is diverted to the 
named file, which, if necessary, is created mode 666. If file is 
missing, output is diverted to the standard output. Note that 
each diversion causes truncation or creation of the file. 

: label 

This positions a label in a command file. The label is ter¬ 
minated by new-line, and blanks between the : and the start of 
the label are ignored. This command may also be used to insert 
comments into a command file, since labels need not be refer¬ 
enced. 
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( . , . )'xh/regular expression/label 

A jump (either upward or downward) is made to label if the com¬ 
mand succeeds. It fails under any of the following conditions: 

1. Either address is not between 1 and S. 

2. The second address is less than the first. 

3. The regular expression doesn't match at least one line 
in the specified range, including the first and last lines. 

On success. . is set to the line matched and a jump is made to 
label. This command is the only one that doesn’t issue an error 
message on bad addresses, so it may be used to test whether 
addresses are bad before other commands are executed. Note 
that the command 

xb/^/ label 

is an unconditional jump. 

The xb command is allowed only if it is read from someplace 
other than a terminal. If it is read from a pipe only a downward 
jump is possible. 

xt number 

Output from the p and null commands is truncated to at most 
number characters. The initial number is 255. 

xv[ digit ] [ spac es ] [ value ] 

The variable name is the specified digit following the xv. xvSlOO 
or xv5 100 both assign the value 100 to the variable 5. 
Xv6l,100p assigns the value l.lOOp to the variable 6. To refer¬ 
ence a variable, put a % in front of the variable name. For 
example, using the above assignments for variables 5 and 6; 


l.%5p 

l.%5 

%6 

will all print the first 100 lines. 
g/%5/p 

would globally search for the characters 100 and print each line 
containing a match. To escape the special meaning of %, a \ 
must precede it. 

g/'’.*\%[cds]/p 

could be used to match and list lines containing print/ of char¬ 
acters, decimal integers, or strings. 

Another feature of the xv command is that the first line of out¬ 
put from a UNIX command can be stored into a variable. The 
only requirement is that the first character of value be an !. 
For example: 

xv5!cat junk 
!rm junk 
!echo '’%5" 
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xv6!expr %6 + 1 

would put the current line into variable 5, print it, and incre¬ 
ment the variable 6 by one. To escape the special meaning of ! 
as the first character of value, precede it with a \. 

xv7\ !date 

stores the value idate into variable 7. 
xbz label 

xbn label 

These two commands will test the last saved return code from 
the execution of a UNIX command {Icommand) or nonzero value, 
respectively, to the specified label. The two examples below 
both search for the next five lines containing the string size. 

xv55 
: 1 

/size/ 

xvSIexpr %5 — 1 
!if 0%5 != 0 exit 2 
xbn 1 
xv45 
: 1 

/size/ 

xv4!expr %4 — I 
!if 0%4 = 0 6xit 2 
xbz 1 

xc [simfc/i] 

If switch is 1, output from the p and null commands is 
crunched; if switch is 0 it isn’t. Without an argument, xc rev¬ 
erses switch. Initially switch is set for no crunching. Crunched 
output has strings of tabs and blanks reduced to one blank and 
blank lines suppressed. 

SEE ALSO 

csplit(l), ed(l), regex(3X). 

DIAGNOSTICS 

? for errors in commands, if prompting is turned off. Self-explanatory 
error messages when prompting is on. 
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NAME 

bs — a compiler/interpreter for modest-sized programs 

SYNOPSIS 

bs [ file [ args ] ] 

DESCRIPTION 

Bs is a remote descendant of Basic and Snobol4 with a little C language 
thrown in. Bs is designed for programming tasks where program 
development time is as important as the resulting speed of execution. 
Formalities of data declaration and file/process manipulation are minim¬ 
ized. Line-at-a-time debugging, the trace and dump statements, and 
useful run-time error messages all simplify program testing. Further¬ 
more, incomplete programs can be debugged; inner functions can be 
tested before outer functions have been written and vice versa. 

If the command line file argument is provided, the file is used for input 
before the console is read. By default, statements read from the file 
argument are compiled for later execution. Likewise, statements entered 
from the console are normally executed immediately (see compile and 
execute below). Unless the final operation is assignment, the result of an 
immediate expression statement is printed. 

Bs programs are made up of input lines. If the last character on a line is 
a \ , the line is continued. Bs accepts lines of the following form; 

statement 
label statement 

A label is a name (see below) followed by a colon. A label and a variable 
can have the same name. 

A bs statement is either an expression or a keyword followed by zero or 
more expressions. Some keywords {clear, compile, !, execute, include, 
ibase, obase, and run) are always executed as they are compiled. 

Statement Syntax; 
expression 

The expression is executed for its side effects (value, assignment or 
function call). The details of expressions follow the description of 
statement types below. 

break 

Break exits from the inner-most for/while loop, 
clear 

Clears the symbol table and compiled statements. Clear is executed 
immediately. 

compile [ expression ] 

Succeeding statements are compiled (overrides the immediate execu¬ 
tion default). The optional expression is evaluated and used as a file 
name for further input. A clear is associated with this latter case. 
Compile is executed immediately. 

continue 

Continue transfers to the loop-continuation of the current for/while 
loop. 
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dump 

The name and current value of every non-local variable is printed. 
After an error or interrupt, the number of the last statement and 
(possibly) the user-function trace are displayed. 

exit [ expression ] 

Return to system level. The expression is returned as process status, 
execute 

Change to immediate execution mode (an interrupt has a similar 
effect). This statement does not cause stored statements to execute 
(see run below). 

for name = expression expression statement 
for name = expression expression 

next 

for expression , expression , expression statement 
for expression , expression . expression 

next 

The for statement repetitively executes a statement (first form) or a 
group of statements (second form) under control of a named variable. 
The variable takes on the value of the first expression, then is incre¬ 
mented by one on each loop, not to exceed the value of the second 
expression. The third and fourth forms require three expressions 
separated by commas. The first of these is the initialization, the 
second is the test (true to continue), and the third is the loop- 
continuation action (normally an increment). 

fun f([a, ... ]) [v, ... ] 
nuf 

Fun defines the function name, arguments, and local variables for a 
user-written function. Up to ten arguments and local variables are 
allowed. Such names cannot be arrays, nor can they be I/O associ¬ 
ated. Function definitions may not be nested. 

freturn 

A way to signal the failure of a user-written function. See the interro¬ 
gation operator (?) below. If interrogation is not present, /return 
merely returns zero. When interrogation is active, freturn transfers 
to that expression (possibly by-passing intermediate function 
returns). 

ibase N 

Jbase sets the input base (radix) to N. The only supported values for 
N are 8, 10 (the default), and 16. Hexadecimal values 10—15 are 
entered as a—f. A leading digit is required (i.e., fOa must be entered as 
OfOa). Ibase (and obase, below) are executed immediately. 

goto name 

Control is passed to the internally stored statement with the matching 
label. 
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if expression statement 
if expression 

[ else 
... ] 
fi 

The statement (first form) or group of statements (second form) is 
executed if the expression evaluates to non-zero. The strings 0 and "" 
(null) evaluate as zero. In the second form, an optional else allows for 
a group of statements to be executed when the first group is not. The 
only statement permitted on the same line with an else is an if -, only 
other /i’s can be on the same line with a fi. The elision of else and if 
into an elif is supported. Only a single fi is required to close an t/ ... 
elif ... [ else ... ] sequence. 

include expression 

The expression must evaluate to a file name. The file must contain bs 
Such statements become part of the program being compiled, source 
statements. Include statements may not be nested. 

obase N 

Obase sets the input base to N (see ibase above). 

onintr label 
onintr 

The onintr command provides program control of interrupts. In the 
first form, control will pass to the label given, just as if a goto had 
been executed at the time onintr was executed. The effect of the 
statement is cleared after each interrupt. In the second form, an 
interrupt will cause bs to terminate. 

return [expression] 

The expression is evaluated and the result is passed back as the value 
of a function.call. If no expression is given, zero is returned. 

run 

The random number generator is reset. Control is passed to the first 
internal statement. If the run statement is contained in a file, it 
should be the last statement. 

stop 

Execution of internal statements is stopped. Bs reverts to immediate 
mode. 

trace [ expression ] 

The trace statement controls function tracing. If the expression is 
null (or evaluates to zero), tracing is turned off. Otherwise, a record 
of user-function calls/retums will be printed. Each return decre¬ 
ments the trace expression value. 

while expression statement 
while expression 

next 

While is similar to for except that only the conditional expression for 
loop-continuation is given. 
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! shell command 

An immediate escape to the Shell. 

# ... 

This statement is ignored. It is used to interject commentary in a pro¬ 
gram. 

Expression Syntax: 
name 

A name is used to specify a variable. Names are composed of a letter 
(upper or lower case) optionally followed by letters and digits. Only 
the first six characters of a name are significant. Except for names 
declared in fun statements, all names are global to the program. 
Names can take on numeric (double fioat) values, string values, or can 
be associated with input/output (see the built-in function open{) 
below). 

name ( [expression [ , expression] ... ] ) 

Functions can be called by a name followed by the arguments in 
parentheses separated by commas. Except for built-in functions 
(listed below), the name must be defined with a fun statement. Argu¬ 
ments to functions are passed by value. 

name [ expression [ , expression ] ... ] 

This syntax is used reference either arrays or tables (see built-in table 
functions below). For arrays, each expression is truncated to an 
integer and used as a specifier for the name. The resulting array 
reference is syntactically identical to a name; a[l,2] is the same as 
a[l][2]. The truncated expressions are restricted to values between 0 
and 32767. 

number 

A number is used to represent a constant value. A number is written 
in Fortran style, and contains digits, an optional decimal point, and 
possibly a scale factor consisting of an e followed by a possibly signed 
exponent. 

string 

Character strings are delimited by " characters. The \ escape char¬ 
acter allows the double quote (\"), new-line (\n), carriage return 
(\r), backspace (\b), and tab (\t) characters to appear in a string. 
Otherwise, \ stands for itself. 

( expression ) 

Parentheses are used to alter the normal order of evaluation. 

( expression, expression [, expression ...])[ expression ] 

The bracketed expression is used as a subscript to select a comma- 
separated expression from the parenthesized list. List elements are 
numbered from the left, starting at zero. The expression; 

( False, True )[ a == b ] 
has the value True if the comparison is true. 

? expression 

The interrogation operator tests for the success of the expression 
rather than its value. At the moment, it is useful for testing end-of- 
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file (see examples in the Programming Tips section below), the result 
of the eval built-in function, and for checking the return from user- 
written functions {see /return). An interrogation “trap'’ (end-of-file, 
etc.) causes an immediate transfer to the most recent interrogation, 
possibly skipping assignment statements or intervening function lev¬ 
els. 

— expression 

The result is the negation of the expression. 

+-h name 

Increments the value of the variable (or array reference). The result 
is the new value. 

— name 

Decrements the value of the variable. The result is the new value. 

! expression 

The logical negation of the expression. Watch out for the shell escape 
command. 

expression operator expression 

Common functions of two arguments are abbreviated by the two argu¬ 
ments separated by an operator denoting the function. Except for the 
assignment, concatenation, and relational operators, both operands 
are converted to numeric form before the function is applied. 

Binary Operators (in increasing precedence); 

= is the assignment operator. The left operand must be a name or an 
array element. The result is the right operand. Assignment binds 
right to left, all other operators bind left to right. 

_(underscore) is the concatenation operator. 

& (logical and) has result zero if either of its argurrients are zero. It 
has result one if both of its arguments are non-zero; 1 (logical or) has 
result zero if both of its arguments are zero. It has result one if either 
of its arguments is non-zero. Both operators treat a null string as a 
zero. 

<= > >= == != 

The relational operators (< less than. <= less than or equal. > greater 
than, >= greater than or equal, == equal to, != not equal to) return 
one if their arguments are in the specified relation. They return zero 
otherwise. Relational operators at the same level extend as follows: 
a>b>c is the same as a>6 & b>c. A string comparison is made if both 
operands are strings. 

Add and subtract. 

/ % 

Multiply, divide, and remainder. 
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Exponentiation. 

Built-in Functions: 

DeaLing wiih arguments 

arg(i) 

is the value of the i-th actual parameter on the current level of func¬ 
tion call. At level zero, arg returns the i-th command-line argument 
(argr(O) returns bs). 

nargO 

returns the number of arguments passed. At level zero, the command 
argument count is returned. 

Mathematical 

abs(x) 

is the absolute value of x. 
atan(x) 

is the arctangent of x. Its value is between —rr/S and 7t/2. 
ceil(x) 

returns the smallest integer not less than x. 
cos(x) 

is the cosine of x (radians). 
exp(x) 

is the exponential function of x. 
floor(x) 

returns the largest integer not greater than x. 
log(x) 

is the natural logarithm of x. 
reuidO 

is a uniformly distributed random number between zero and one. 
sin(x) 

is the sine of x (radians). 
sqrt(x) 

is the square root of x. 

String operations 

size(s) 

the size (length in bytes) of s is returned. 
format(f, a) 

returns the formatted value of a. F is assumed to be a format 
specification in the style of printfiZS). Only the and 

%... s types are safe. 

index(x. y) 

returns the number of the first position in x that any of the charac¬ 
ters from y matches. No match yields zero. 

trans(s. f, t) 

Translates characters of the source s from matching characters in / 
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to a character in the same position in t. Source characters that do 
not appear in / are copied to the result. If the string / is longer than 
t, source characters that match in the excess portion of / do not 
appear in the result. 

substr(s, start, width) 

returns the sub-string of s defined by the sfar^ing position and width. 

match(string. pattern) 
mstring(n) 

The pattern is similar to the regular expression syntax of the ed{\) 
command. The characters .. [. ]. ^ (inside brackets). • and S are spe¬ 
cial. The mstring function returns the n-th (1 <= n <= 10) substring 
of the subject that occurred between pairs of the pattern symbols \( 
and \) for the most recent call to match. To succeed, patterns must 
match the beginning of the string (as if all patterns began with .-v). 
The function returns the number of characters matched. For exam¬ 
ple: 

match("al23abl23'’. ".•\ ([a-z]\)") == 6 
mstring(l) == "b" 

File handling 

open(name, file, function) 
close(neune) 

The name argument must be a bs variable name (passed as a string). 
For the open, the file argument may be 1) a 0 (zero). 1, or 2 
representing standard input, output, or error output, respectively. 2) 
a string representing a file name, or 3) a string beginning with an ! 
representing a command to be executed (via sh —c). The function 
argument must be either r (read), w (write), W (write without new-line), 
or a (append). After a close, the name reverts to being an ordinary 
variable. The initial associations are: 

openC'get", 0, "r") 
openC'put", 1, "w”) 
open(''puterr'', 2, "w") 

Examples are given in the following section. 

access(s. m) 

executes access(2). 

ftype(s) 

returns a single character file type indication: f for regular file, d for 
directory, b for block special, or c for character special. 

Tables 

table(name, size) 

A table in 6s is an associatively accessed, single-dimension array. 
“Subscripts’* (called keys) are strings (numbers are converted). The 
name argument must be a 6s variable name (passed as a string). The 
size argument sets the minimum number of elements to be allocated. 
Bs prints an error message and stops on table overflow. 

item(neaTie, i) 
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The item function accesses table elements sequentially (in normal 
use. there is no orderly progression of key values). Where the item 
function accesses values, the key function accesses the "subscript” of 
the previous item call. The name argument should not be quoted. 
Since exact table sizes are not defined, the interrogation operator 
should be used to detect end*of-table, for example: 

table("t". 100) 

# If word contains "party", the following expression adds one to 
the count 

# of that word: 

++t[word] 

# To print out the the key/value pairs: 

for i = 0. ?(s = item(t. i)). ++i if key() put = key()_":"_s 

iskey(name, word ) 

The iskey function tests whether the key word exists in the table 
name and returns one for true, zero for false. 

Odds and ends 


eval(s) 

The string argument is evaluated as a bs expression. The function is 
handy for converting numeric strings to numeric internal form. EvaL 
can also be used as a crude form of indirection, as in; 

name = "xyz" 
eval("++"_ name) 

which increments the variable xyz. In addition, evaL preceded by the 
interrogation operator permits the user to control bs error condi¬ 
tions. For example: 

?eval("open(\"X\". \"XXX\". \"r\")") 

returns the value zero if there is no file named “XXX" (instead of halt¬ 
ing the user’s program). The following executes a goto to the label L 
(if it exists): 

label="L" 

if !(?eval("goto label)) puterr = "no label" 
plot(request, args) 

The plot function produces output on devices recognized by tpLot{lG). 
The requests are as follows: 


Call 

plot(0. term) 


plot( 1) 

plot(2, string) 
plot(3. xl, yl, x2, y2) 


Function 

causes further plot output to be piped 
into fj3fo^(lG.) with an argument of 
—Tferm. 

"erases" the plotter. 

labels the current point with string. 

draws the line between {xl.yl) and 
{x2,y2). 
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plot(4, X. y, r) draws a circle with center (x.y) and 

radius r. 

plot(5, xl, yl, x2, y2, x3, y3) 

draws an arc (counterclockwise) with 
center (xi.yi) and endpoints {x2,y2) 
and {x3,y3). 

is not implemented, 
makes the current point {x,y). 

draws a line from the current point to 

(*.!/)• 

draws a point at (x,y). 

sets the line mode to string. 

makes {xl,yl) the lower left corner of 
the plotting area and {x2,y2) the upper 
right corner of the plotting area. 

causes subsequent x (y) coordinates to 
be multiplied by xl {yl) and then added 
to x2 (y2) before they are plotted. The 
initial scaling is plot(l2. 1.0, 1.0, 0.0, 
0 . 0 ). 

Some requests do not apply to all plotters. All requests except zero 
and twelve are implemented by piping characters to fpfof(lG). See 
plot {5) for more details. 

last( ) 

in immediate mode, last returns the most recently computed value. 

PROGRAMMING TIPS 

Using 6s as a calculator: 

S bs 

# Distance (inches) light travels in a nanosecond. 

186000 • 5280 • 12 / le9 
11.78496 


§ Compound interest (6% for 5 years on 81,000). 
int = .06 / 4 
bal = 1000 

for i = 1 5*4 bal = bal + bal*int 

bal - 1000 

346.855007 

exit 

The outline of a typical 6s program: 

# initialize things: 
varl = 1 

openC’read". "infile". "r") 


plot(6) 
plot(7. X. y) 
plot(8, X, y) 

plot(9. X, y) 
plot(10. string) 
plot(ll, xl, yl, x2. y2) 

plot(l2, xl, yl, x2, y2) 
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§ compute: 
while ?(str = read) 

next 

§ clean up: 
close("read'') 

§ last statement executed (exit or stop): 
exit 

§ last input line: 
run 

Input/Output examples: 

# Copy "oldfile" to "newfile". 
open(''read", "oldfile’', "r") 
openC'write", "newfile", "w") 

while ?(write = read) 

# close "read" and "write": 
close("read") 
close("write") 

# Pipe between commands. 
open("ls", "!ls "r") 
open("pr", "!pr —2 —h 'List'", "w") 
while ?(pr = Is) ... 

§ be sure to close (wait for) these: 
closeC'ls") 

close(''pr'') ^ 

SEE ALSO 

ed(l), sh(l), tplot(lG), access(2), printf(3S), stdio(3S), Section 3 of this 
volume for further description of the mathematical functions (pow(3M) is 
used for exponentiation), plot(5). Bs uses the Standard Input/Output 
package. 

REMARKS 

Bs exists in 3 different versions on the CADMUS: bs.ffp, bs.mot and bs.nsc. 
The name bs is linked to bs.ffp. These three programs are compiled with 
the 3 different floating point versions of cc, see fp{3). 
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NAME 

cal — print calendar 
SYNOPSIS 

cal [ month ] year 
DESCRIPTION 

Cal prints a calendar for the specified year. If a month is also specified, 
a calendar just for that month is printed. Year can be between 1 and 
9999. The month is a number between 1 and 12. The calendar produced 
is that for England and her colonies. 

Try September 1752. 

BUGS 

The year is always considered to start in January even though this is his¬ 
torically naive. 

Beware that ‘cal 78’ refers to the early Christian era, not the 20th cen¬ 
tury. 
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NAME 

calendar — reminder service 

SYNOPSIS 

calendar [ — ] 

DESCRIPTION 

Calendar consults the file calendar in the current directory and prints 
out lines that contain today’s or tomorrow's date anywhere in the line. 
Most reasonable month-day dates such as "Dec. 7.” "december 7," 
••12/7," etc., are recognized, but not ^^7 December’ or "7/12’'. On week¬ 
ends "tomorrow" extends through Monday. 

When an argument is present, calendar does its job for every user who 
has a file calendar in his login directory and sends him any positive 
results by maiZ(l). Normally this is done daily in the wee hours under 
control of cron(8). 

FILES 

calendar 

/usr/lib/calprog to figure out today’s and tomorrow’s dates 

/etc/passwd 

/tmp/cal* 

/usr/lib/crontab 

SEE ALSO 

cron(8), mail(l). 

BUGS 

Your calendar must be public information for you to get reminder ser¬ 
vice. 

Calendar's extended idea of "tomorrow" does not account for holidays. 
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NAME 

cat - concatenate and print files 
SYNOPSIS 

cat [ -u ] [ -s ] file ... 

DESCRIPTION 

Cat reads each file in sequence and writes it on the standard outout 
Thus: ■ 

cat file 

prints the file, and: 

cat filel files >file3 

concatenates the first two files and places the result on the third. 

If no input file is given, or if the argument — is encountered, cat reads 
from the standard input file. Output is buffered in 512-byte blocks 
unless the -u option is specified. The -s option makes cat silent about 
non-existent files. No input file may be the same as the output file unless 
it is a special file. 

SEE ALSO 

cp(l), pr(l). 
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NAME 

cb — C program beautifier 

SYNOPSIS 

cb 

DESCRIPTION 

Cb places a copy of the C program from the standard input on the stan¬ 
dard output with spacing and indentation that displays the structure of 
the program. 
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NAME 

cc, Icc — C compiler 
SYNOPSIS 

cc [ option ] ... file ... 

DESCRIPTION 

Cc is the UNIX C compiler. It accepts several types of arguments: 

Arguments whose names end with '.c' are taken to be C source programs- 
they are compiled, and each object program is left on the file whose 
name is that of the source with '.o’ substituted for ’.c*. The '.o’ file is nor¬ 
mally deleted, however, if a single C program is compiled and linked all at 
one go. This C-compiler has the identifier ''m60OOO” predefined such 
that "^ifdef m68000'' is true. 

A call "cc test.c" is the same as "cc -c test.c && Id /lib/crtO.o test.o -Ic 
ScSc rm test.o". The call "cc ‘.o" is the same as "Id /lib/crtO.o *0 -Ic". If 
your directory contains the file xyz.c, a call "make xyz" will result in "cc 
-o xyz xyz.c". 

The following options are interpreted by cc. See fof(l) for link-time 
options. 

—c Suppress the linking phase of the compilation, and force an 

object file to be produced even if only one program is compiled. 

—o output 

Name the final output file output. If this option is’used the file 
•a.out' will be left undisturbed. This option is passed on to the 
linker. 

-f[FN] This option must be given, if the program includes floating point 
operations. The option -f alone will compile code for the Motorola 
Fast Floating Point Package, which is fast but does not have dou¬ 
ble precision arithmetic. 

The option -fF will compile code for the Motorola IEEE Floating 
Point Package, and later for the Motorola floating point coproces- 
This package offers single and double precision according to 
the IEEE specifications. As long as the coprocessor is not avail¬ 
able, the execution speed is rather slow. 

The option -fN will compile code for the CADMUS FPP board with a 
NSC 16081 floating point processor. The numbers are also in IEEE 
format, but the generated code is much different from the one 
produced with option -fF. 

With option -f. the library libffp.a will be searched before libc.a, 
with option -fF the library libmot.a. with option -fN the library 
libnsc.a. These libraries contain also the code which was formerly 
in the mathematical library libm.a. This library has been removed. 
Option -f makes the option -DFFP implicit. Option -fF makes the 
options -DIEEE and -DMOT_IEEE implicit. Option -fN makes the 
options -DIEEE and -DNSC_^lEEE implicit. 

S Compile the named C programs, and produce an assembly listing 
on corresponding files suffixed *.s*. This option is used mainly for 
compiler debugging. 
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—L Arrange for the compiler to produce code which puts the current 

linenumber into the stackframe during execution. The C- 
stacktrace of ad6(l) (command Sc or SC) will then give for each 
active procedure the current linenumber. 

—g Adds entries to the symbol table of the produced .o module which 
indicate line numbers and corresponding code location. To set a 
breakpoint at line 75 you can tell adb ";b L75''. Make sure that 
only one module of a program is compiled with this option. 

—p Arrange for the compiler to produce code which counts the 

number of times each routine is called; also, if linking takes 
place, replace the standard startup routine by one which 
automatically calls m.omfor(3C) at the start and arranges to write 
out a mon.ouf file at normal termination of execution of the 
object program. An execution profile can then be generated by 
use of pro/(l). 

—T With this option initialized data is put into the text- rather than 

the data segment. Thus for programs like the shell, whose text 
segments are shared between many users, memory space can be 
saved. Apply this option only to modules with nothing but con¬ 
stant data declarations. 

—u All characters will be treated as "unsigned char". 

—4 Changes the integer size from 2 (default) to 4. This makes pro¬ 

grams which neglect the differences between int and pointer or 
int and long much more portable. On the other hand, the pro¬ 
duced code is less efficient. When the name Icc is linked to cc, Icc 
is equivalent to cc -4. This option is also passed to the linker. The 
linker transforms the option -llib to -ILlib, e.g. -Ic to -ILc or 
-Icurses to -ILcurses. These libraries are themselves compiled 
with option -4. 

—2 Like option -4. However, short parameters remain short and char 
parameters are only converted to short, not int. before they are 
pushed on the stack. This option is used for example to compile 
the system calls in the 4-byte-integer standard library 
/lib/libLc.a, which must interface to a 2-byte-integer world. 

—P Run only the macro preprocessor and place the result for each 
‘.c’ file in a corresponding ‘.i’ file that has no lines in it. 

—E Run only the macro preprocessor and send the result to the stan¬ 

dard output. The output is intended for compiler debugging; it is 
unacceptable as input to cc. 

—Dname=de/ 

—Dname 

Define the name to the preprocessor, as if by ‘^define’. If no 
definition is given, the name is defined as 1. 

—Uname 

Remove any initial definition of name. 

—Idir ‘jjfinclude’ files whose names do not begin with V are always 

sought first in the directory of the file argument, then in 
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directories named in —I options, then in directories on a standard 
list. 

Find substitute compiler passes in the files named string with the 
suffixes cpp, cO, cl and c2. If string is empty, use a standard 
backup version. 

-t[p012] 

Find only the designated compiler passes in the files whose names 
are constructed by a —B option. In the absence of a —B option, 
the string is taken to be ’/usr/src/cmd/c/’. 

Other arguments are taken to be either linker option arguments, or C- 
compatible object programs, typically produced by an earlier cc run, or 
perhaps libraries of C-compatible routines. These programs, together 
with the results of any compilations specified, are linked (in the order 
given) to produce an executable program with name a.out. 

FILES 

file.c 
file.o 
a.out 

/tmp/ctm* 

/lib/cpp 
/lib/c[0l2] 

/lib/oc[0l2] 

/lib/ocpp 
/lib/crtO.o 
/lib/IcrtO.o 
/lib/mlcrtO.o 
/lib/libc.a 
/lib/libLc.a 
/lib/libffp.a 
/lib/libmot.a 

/lib/libnsc.a 

/usr/include 
SEE ALSO 

B. W. Kernighan and D. M. Ritchie, The C Programming Language, 

Prentice-Hall, 1978 

D. M. Ritchie, CReference Manual 

monitor(3C), prof(l), adb(l), ld(l), fp(3) 

DIAGNOSTICS 

The diagnostics produced by C itself are intended to be self-explanatory. 
Occasional messages may be produced by the linker. 


input file 

object file 

linked output 

temporaries for cc 

preprocessor 

compiler passes for cc 

backup compiler passes for cc 

backup preprocessor 

runtime initialization 

runtime initialization for option -4 

runtime initialization for profiling and option -4 

standard library, see tnfro (3) 

standard library for option -4 

library with fast floating point routines 

library with IEEE floating point routines for Motorola 

package 

library with IEEE floating point routines for FPP board 
with NSC 16001 

standard directory for ‘^include’ files 


Page 3 


February 17, 1984 










r 


€ 


CD(1) 


MUNIX 


CD(1) 


NAME 


cd — change working directory 


SYNOPSIS 


cd [ directory ] 


DESCRIPTION 


If directory is not specified, the value of shell parameter SHOME is used as 
the new working directory. If directory specifies a complete path start¬ 
ing with /. directory becomes the new working directory. If neither 

case applies, cd tries to find the designated directory relative to one of 
the paths specified by the SCDPATH shell variable. SCDPATH has the same 
syntax as, and similar semantics to, the IPATH shell variable. Cd must 
have execute (search) permission in directory. 

Because a new process is created to execute each command, cd would be 
ineffective if it were written as a normal command: therefore, it is recog¬ 
nized and internal to the shell. 



SEE ALSO 


pwd(l), sh(l), chdir(2). 



Page 1 


February 17, 1984 













'^Ih ^hjibuy'^ ,‘:S^c:c 


•/•: o ■:xrb ■;: b v 



Zi^!:.K^-^.^ ^1 bM(b-;V ■:-Jv.ri.sic. .;■ {I'.-.v J ..V <:;r S'T .b* .*: c^' '‘•r u 

'j ii'.:- ; ^l;,;.iC ^-7';^'iT: i!.' i. -r/-■ ' ';]•■'?■;■'.'O >::!);T'';'i' - ' 

■ :-;’'j‘-r-. il; :-/-o.j-‘riil v.'b ^-.n b 



^ -.n b ■'^w:. 


^ r :riX4^l3lf .s;di>h/:v ffaiia HTry'iiGDI ••■ vb; D3br'ficp;. ‘'r[rmr-^:^f 

b..:Ti :.C'' :vb-Jcr;^v !i-b'tv‘'H!ASS itb ' ,o; c:'^\J'xr^cr. ■■:. ^^A^rbU hn^^^,: f:^- K:^Any^ 

■ . y^'-'o'iD3r>b rn ^Han ■ 

-b blwK^v; t;. b'. ;.a*> o) &r r.--o^ua::: b 

-So:::;‘:r: :>j j' ,S 1 •‘■^•: t , .l£..:r7()n n c- a ";:v: :,: 

^ ; ' ■ _ '^riJ C'b,ii,n ia v'v ,': 

’ ' ’ • ■.. •bbj/'- bP"b:: 




; b.j I :■? 1 s ^ 


/ 




CDC(l) 


MUNIX 


CDC(l) 


NAME 

cdc — change the delta commentary of an SCCS delta 
SYNOPSIS 

cdc —rSlD [—m[mrlist]] [—/[comment]] files 
DESCRIPTION 

Cdc changes the delta commentary, for the SID specified by the —r 
keyletter, of each named SCCS file. 

Delta commentary is defined to be the Modification Request (MR) and 
comment information normally specified via the delta{l) command (—m 
and —y keyletters). 

If a directory is named, cdc behaves as though each file in the directory 
were specified as a named file, except that non-SCCS files (last com¬ 
ponent of the path name does not begin with s.) and unreadable files are 
silently ignored. If a name of — is given, the standard input is read (see 
WARNINGS)', each line of the standard input is taken to be the name of an 
SCCS file to be processed. 

Arguments to cdc, which may appear in any order, consist of keyletter 
arguments, and file names. 

All the described keyletter arguments apply independently to each 
named file: 

—tSID Used to specify the 5CCS /Z?entification {SID) string of 

a delta for which the delta commentary is to be 
changed. 

—rii[mriisf] If the SCCS file has the v flag set (see admin(l)) then a 

list of MR numbers to be added and/or deleted in the 
delta commentary of the SID specified by the —r 
keyletter may be supplied. A null MR list has no effect. 

MR entries are added to the list of MRs in the same 
manner as that of delta{\). In order to delete an MR, 
precede the MR number with the character ! (see EXAM¬ 
PLES). If the MR to be deleted is currently in the list of 
MRs, it is removed and changed into a ’'comment” line. 
A list of all deleted MRs is placed in the comment sec¬ 
tion of the delta commentary and preceded by a com¬ 
ment line stating that they were deleted. 

If —m is not used and the standard input is a terminal, 
the prompt MRs? is issued on the standard output 
before the standard input is read; if the standard 
input is not a terminal, no prompt is issued. The MRs? 
prompt always precedes the comments? prompt (see 
—y keyletter). 

MRs in a list are separated by blanks and/or tab char¬ 
acters. An unescaped new-line character terminates 
the MR list. 

Note that if the v flag has a value (see admin{\)), it is 
taken to be the name of a program (or shell pro¬ 
cedure) which validates the correctness of the MR 
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numbers. If a non-zero exit status is returned from 
the MR number validation program, cdc terminates and 
the delta commentary remains unchanged. 

-y[coTnmenf] Arbitrary text used to replace the comment{s) already 
existing for the delta specified by the —r keyletter. 
The previous comments are kept and preceded by a 
comment line stating that they were changed. A null 
comment has no effect. 

If —y is not specified and the standard input is a termi¬ 
nal, the prompt comments? is issued on the standard 
output before the standard input is read; if the stan¬ 
dard input is not a terminal, no prompt is issued. An 
unescaped new-line character terminates the com¬ 
ment text. 

The exact permissions necessary to modify the SCCS file are docu¬ 
mented in the Source Code Control System User's Guide. Simply 
stated, they are either (l) if you made the delta, you can change its 
delta commentary: or (2) if you own the file and directory you can 
modify the delta commentary. 

EXAMPLES 

cdc -rl.6 -m"bl78-12345 !bl77-5432l bl79-00001" -ytrouble s.file 

adds bl70-12345 and bl79-00001 to the MR list, removes bl77-5432l from 
the MR list, and adds the comment trouble to delta 1.6 of s.file. 

cdc —rl.6 s.file 

MRS? !bl77-5432l bl78-12345 bl79-00001 
comments? trouble 

does the same thing. 

WARNINGS 

If SCCS file names are supplied to the cdc command via the standard 
input (— on the command line), then the —m and —y keyletters must also 
be used. 

FILES 

x-file (see delta{l)) 
z-file (see deifa(l)) 

SEE ALSO 

admin(l). delta(l). get(l). help(l). prs(l). sccsfile(5). 

Source Code Control ^stem User’s Guide by L. E. Bonanni and C. A. 
Salemi. 

DIAGNOSTICS 

Use h.elp{l) for explanations. 
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NAME 

checknews — check to see if user has news 
SYNOPSIS 

checknews [ ynqew ] [ readnews options ] 


DESCRIPTION 

checknews reports to the user whether or not he has news. 

y Reports "There is news” if the user has news to read. 

n Reports "No news” if there isn’t any news to read. 

q causes checknews to be quiet. Instead of printing a message. 

the exit status indicates news. A status of 0 means no news. 1 
means there is news. 

V alters the y message to show the name of the first newsgroup 

containing unread news. Doubling v (e.g. w) will cause an 
explanation of any claim of new news, and is useful if check- 
news and readnews disagree on whether there is news. 

e Executes readnews{\) if there is news. 


If there are no options, y is the default. 


FILES 


~/.newsrc Options and list of previously read articles 

/usr/lib/news/active 

Active newsgroups 


SEE ALSO 

inews(l). postnews(l). readnews(l) 
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NAME 

checknr — check nroff/trofl files 
SYNOPSIS 

checknr [ -s ] [ -f ] [ -a.xl.yl.x2.y2.xn.yn ] [ -c.xl.x2.x3 ... .xn ] 

[ file ... ] 

DESCRIPTION 

Checknr checks a list of nroff{\) or input files for certain kinds of 

errors involving mismatched opening and closing delimiters and unknown 
commands. If no files are specified, checknr checks the standard input. 
Delimeters checked are: 

(1) Font changes using\fx ... \ fP. 

(2) Size changes using \ sx ... \ sO. 

(3) Macros that come in open ... close forms, for example, the .TS and 
.TE macros which must always come in pairs. 

Checknr knows about the ms (7) and me (7) macro packages. 

Additional pairs of macros can be added to the list using the —a option. 
This must be followed by groups of six characters, each group defining a 
pair of macros. The six characters are a period, the first macro name, 
another period, and the second macro name. For example, to define a 
pair .BS and .ES, use —a.BS.ES 

The —c option defines commands which would otherwise be complained 
about as undefined. 

The —f option requests checknr to ignore \f font changes. 

The —s option requests checknr to ignore \s size changes. 

Checknr is intended to be used on documents that are prepared with 
. checknr in mind, much the same as lint. It expects a certain document 
writing style for \f and \s commands, in that each \fx must be ter¬ 
minated with \fP and each \sx must be terminated with \s0. While it 
will work to directly go into the next font or explicitly specify the original 
font or point size, and many existing documents actually do this, such a 
practice will produce complaints from checknr. Since it is probably 
better to use the \fP and \s0 forms anyway, you should think of this as 
a contribution to your document preparation style. 

SEE ALSO 

nrofT(l). trofT(l), ms(7), me(7), checkeqn(l) 

DIAGNOSTICS 

Complaints about unmatched delimiters. 

Complaints about unrecognized commands. 

Various complaints about the syntax of commands. 

AUTHOR 

Mark Horton 

BUGS 

There is no way to define a 1 character macro name using —a 
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NAME 

chfn — change full name of user 

SYNOPSIS 

chfn name string 

DESCRIPTION 

Chfn is a command similar to passwd{l) except that it is used to change 
the geos field of the password file rather than the password entry. Note 
that the string specified will replace the entire gecos field of the specified 
user. If (as on the UCB system) this field contains information in addi¬ 
tion to the user’s full name, this information must be included in string 
or it will be deleted. Hence chfn can be used to fix phone numbers, 
offices, etc. 

An example use of this command would be 

chfn mark "it Horton,508E,7686,5240633' 

Note that the string must in general be quoted to shield blanks and spe¬ 
cial characters from the shell. The field should consist of the users 
name, followed by their office number, followed by the last 4 digits of 
their office extension and finally their home phone number. Any of these 
can be omitted. There should be no spaces in the entry except for those 
in your name. 

It is a good idea to run /fnper(l) on the user before and after chfn to 
make sure you have formatted the data correctly. 

SEE ALSO 

finger(l), passwd(5), passwd(l) 

AUTHOR 

Mark Horton 

BUGS 

The encoding of the office and extension information is installation 
dependent. 
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NAME 

chmod — change mode 
SYNOPSIS 

chmod mode file ... 

DESCRIPTION 

The permissions of each named file are changed according to mode, 
which may be absolute or symbolic. An absolute mode is an octal number 
constructed from the OR of the following modes; 

4000 set user ID on execution 

2000 set group ID on execution 

1000 sticky bit, see chmod{Z) 

0400 read by owner 

0200 write by owner 

0100 execute (search in directory) by owner 
0070 read, write, execute (search) by group 
0007 read, write, execute (search) by others 

A symbolic mode has the form: 

[lu/io] op permission [ op permission ] 

The who part is a combination of the letters u (for user's permissions), g 
(group) and o (other). The letter a stands for ugo, the default if who is 
omitted. 

Op can be + to add permission to the file’s mode, — to take ay permis¬ 
sion, or = to assign permission absolutely (all other bits will be reset). 

Permission is any combination of the letters r (read), w (write), x (exe¬ 
cute), s (set owner or group ID) and t (save text — sticky); u, g or o indi¬ 
cate that permission is to be taken from the current mode. Omitting 
permission is only useful with = to take away all permissions. 

Multiple symbolic modes separated by commas may be given. Operations 
are performed in the order specified. The letter s is only useful with u or 
g and t only works with u. 

Only the owner of a file (or the super-user) may change its mode. 
EXAMPLES 

The first example denies write permission to others, the second makes a 
file executable, the third makes a file readable and executable by every¬ 
body, and writable by the owner. 

chmod o—w file 
chmod+x file 
chmod 0755 file 

SEE ALSO 

ls(l), chmod(2). 
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NAME 

chown. chgrp — change owner or group 
SYNOPSIS 

chown owner file ... 
chgrp group file ... 

DESCRIPTION 

Choum changes the owner of the flies to owner. The owner may be either 
a decimal user ID or a login name found in the password file. 

Chgrp changes the group ID of the flies to group. The group may be 
either a decimal group ID or a group name found in the group file. 

FILES 

/etc/passwd 
/etc/group 

SEE ALSO 

chown(2). group(5). passwd(5). 
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NAME 

clear — clear terminal screen 

SYNOPSIS 

clear 

DESCRIPTION 

Clear clears your screen if this is possible. It looks in the environment 
for the terminal type and then in /etc/termcap to figure out how to clear 
the screen. 

FILES 

/etc/termcap terminal capability data base 
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NAME 

cmp — compare two files 
SYNOPSIS 

cmp [ —1 ] [ — s ] filel files 
DESCRIPTION 

The two files are compared. (If filel is the standard input is used.) 
Under default options, cmp makes no comment if the files are the same; 
if they differ, it announces the byte and line number at which the 
difference occurred. If one file is an initial subsequence of the other, 
that fact is noted. 

Options: 

—1 Print the byte number (decimal) and the differing bytes (octal) for 
each difference. 

—s Print nothing for differing files; return codes only. 

SEE ALSO 

comm(l), diff(l). 

DIAGNOSTICS 

Exit code 0 is returned for identical files. 1 for different files, and 2 for 
an inaccessible or missing argument. 
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NAME 

col — filter reverse line feeds 

SYNOPSIS 

col [—bfx] 

DESCRIPTION 

Col reads the standard input and writes the standard output. It performs 
the line overlays implied by reverse line feeds (ESC-7 in ASCII) and by 
forward and reverse half line feeds (ESC-9 and ESC-8). Col is particularly 
useful for filtering multicolumn output made with the '.rt' command of 
nroff and output resulting from use of the tbl{l) preprocessor. 

Although col accepts half line motions in its input, it normally does not 
emit them on output. Instead, text that would appear between lines is 
moved to the next lower full line boundary. This treatment can be 
suppressed by the —f (fine) option; in this case the output from col may 
contain forward half line feeds (ESC-9), but will still never contain either 
kind of reverse line motion. 

If the —b option is given, col assumes that the output device in use is not 
capable of backspacing. In this case, if several characters are to appear 
in the same place, only the last one read will be taken. 

The control characters SO (ASCII code 017), and SI (016) are assumed to 
start and end text in an alternate character set. The character set (pri¬ 
mary or alternate) associated with each printing character read is 
remembered; on output, SO and SI characters are generated where 
necessary to maintain the correct treatment of each character. 

Col normally converts white space to tabs to shorten printing time. If the 
—X option is given, this conversion is suppressed. 

All control characters are removed from the input except space, back¬ 
space, tab, return, newline, ESC (033) followed by one of 789, SI, SO, and 
VT (013). This last character is an alternate form of full reverse line 
feed, for compatibility with some other hardware conventions. All other 
non-printing characters are ignored. 

SEE ALSO 

trofr(l), tbl(l), greek(l) 

BUGS 

Can't back up more than 128 lines. 

No more than 800 characters, including backspaces, on a line. 
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NAME 

colcrt - filter nroff output for CRT previewing 
SYNOPSIS 

colcrt [ - ] [ -2 ] [ file ... ] 

DESCRIPTION 

Colcrt provides virtual half-line and reverse line feed sequences for ter¬ 
minals without such capability, and on which overstriking is destructive. 
Half-line characters and underlining (changed to dashing •-’) are placed 
on new lines in between the normal output lines. 

The optional — suppresses all underlining. It is especially useful for pre¬ 
viewing alLboxed tables from f6f(l). 

The option -2 causes all half-lines to be printed, effectively double spac¬ 
ing the output. Normally, a minimal space output format is used which 
will suppress empty lines. The program never suppresses two consecu¬ 
tive empty lines, however. The -2 option is useful for sending output to 
the line printer when the output contains superscripts and subscripts 
which would otherwise be invisible. 

A typical use of cofcrf would be 

tbl exum2.n | nroff -ms | colcrt - | more 

SEE ALSO 

nroff/troff(l), col(l), more(l), ul(l) 

AUTHOR 

William Joy 

BUGS 

Should fold underlines onto blanks even with the option so that a true 
underline character would show; if we did this, however, colcrt wouldn’t 
get rid of cu'd underlining completely. 

Can't back up more than 102 lines. 

General overstriking is lost; as a special case ’I’ overstruck with or 
underline becomes ' + '. 

Lines are trimmed to 132 characters. 

Some provision should be made for processing superscripts and sub¬ 
scripts in documents which are already double-spaced. 
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NAME 

coirm — remove columns from a file 
SYNOPSIS 

coirm [ started [ ended ] ] 

DESCRIPTION 

Coirm removes selected columns from a file. Input is taken from stan¬ 
dard input. Output is sent to standard output. 

If called with one parameter the columns of each line will be removed 
starting with the specified column. If called with two parameters the 
columns from the first column to the last column will be removed. 

Column numbering starts with column 1. 


SEE ALSO 

expand( 1) 

AUTHOR 

Jeff Schriebman 
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NAME 

comb — combine SCCS deltas 
SYNOPSIS 

comb [—o] [—s] [—psid] [—clist] files 
DESCRIPTION 

Comb generates a shell procedure (see 5/i(l)) which, when run, will 
reconstruct the given SCCS files. The reconstructed files will, hopefully, 
be smaller than the original files. The arguments may be specified in any 
order, but all keyletter arguments apply to all named SCCS files. If a 
directory is named, comb behaves as though each file in the directory 
were specified as a named file, except that non-SCCS files (last com¬ 
ponent of the path name does not begin with s.) and unreadable files are 
silently ignored. If a name of — is given, the standard input is read; each 
■ line of the standard input is taken to be the name of an SCCS file to be 
processed; non-SCCS files and unreadable files are silently ignored. 

The generated shell procedure is written on the standard output. 

The keyletter arguments are as follows. Each is explained as though only 
one named file is to be processed, but the effects of any keyletter argu¬ 
ment apply independently to each named file. 

—pSlD The 5CCS /ZJentification string (SID) of the oldest delta to be 
preserved. All older deltas are discarded in the reconstructed 
file. 

—clist A List (see pef(l) for the syntax of a list) of deltas to be 
preserved. All other deltas are discarded. 

—o For each get —e generated, this argument causes the recon¬ 

structed file to be accessed at the release of the delta to be 
created, otherwise the reconstructed file would be accessed at 
the most recent ancestor. Use of the —o keyletter may decrease 
the size of the reconstructed SCCS file. It may also alter the 
shape of the delta tree of the original file. 

—s This argument causes comb to generate a shell procedure which, 

when run, will produce a report giving, for each file: the file name, 
size (in blocks) after combining, original size (also in blocks), and 
percentage change computed by: 

100 • (original — combined) / original 
It is recommended that before any SCCS files are actually com¬ 
bined, one should use this option to determine exactly how much 
space is saved by the combining process. 

If no keyletter arguments are specified, comb will preserve only leaf del¬ 
tas and the minimal number of ancestors needed to preserve the tree. 

FILES 

s.COMB The name of the reconstructed SCCS file, 

comb????? Temporary. 

SEE ALSO 

admin(l), delta(l), get(l), help(l), prs(l), sccsfile(5). 

Source Code Control ^stem User's Guide by L. E. Bonanni and C. A. 
Salemi. 
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DIAGNOSTICS 

Use heLp{l) for explanations. 


BUGS 


Comb may rearrange the shape of Ihe tree of deltas It may not save any 
space; in fact, it is possible lor the reconstructed file to actually be 
larger than the original. 
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NAME 

comm — select or reject lines common to two sorted files 
SYNOPSIS 

comm [ — [ 123 ] ] filel file2 
DESCRIPTION 

Comm reads filel and file2, which should be ordered in ASCII collating 
sequence, and produces a three column output: lines only in filel; lines 
only in file2: and lines in both files. The filename means the standard 
input. 

t 

Flags 1, 2, or 3 suppress printing of the corresponding column. Thus 
comm —12 prints only the lines common to the two files; comm —23 prints 
only lines in the first file but not in the second; comm —123 is a no-op. 

SEE ALSO 

cmp(l), difT(l). uniq(l) 
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NAME 

compact, uncompact, ccat — compress and uncompress files, and cat 
them 

SYNOPSIS 

compact [ name ... ] 
uncompaci [ name ... ] 

ccat [ file ... ] 

DESCRIPTION 

Compact compresses the named files using an adaptive Huffman code. If 
no file names are given, then the standard input is compacted to the 
standard output. Compact operates as an on-line algorithm. Each time a 
byte is read, it is encoded immediately according to the current prefix 
code. This code is an optimal Huffman code for the set of frequencies 
seen so far. It is unnecessary to prepend a decoding tree to the 
compressed file since the encoder and the decoder start in the same 
state and stay synchronized. Furthermore, compact and uncompact can 
operate as filters. In particular, 

... I compact I uncompact | ... 

operates as a (very slow) no-op. 

When an argument file is given, it is compacted and the resulting file is 
placed in file.C; file is unlinked. The first two bytes of the compacted file 
code the fact that the file is compacted. This code is used to prohibit 
recompaction. 

The amount of compression to be expected depends on the type of file 
being compressed. Typical values of compression are: Text (38%), Pascal 
Source (43%), C Source (36%) and Binary (19%). These values are the 
percentages of file bytes reduced. 

Uncompact restores the original file from a file compressed by compact. 
If no file names are given, then the standard input is uncompacted to the 
standard output. 

Ccat cats the original file from a file compressed by compact, without 
uncompressing the file. 

RESTRICTION 

The last segment of the filename must contain fewer than thirteen char¬ 
acters to allow space for the appended ’.C’. 

FILES 

•.C compacted file created by compact, removed by uncompact 

SEE ALSO 

Gallager, Robert G., "Variations on a Theme of Huffman", I.E.E.E. Tran¬ 
sactions on information Theory, vol. IT-24, no. 6, November 1978, pp. 668 
- 674. 

AUTHOR 

Colin L. Me Master 
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NAME 


cp. In. mv - copy, link or move files 


SYNOPSIS 

cp filel [ files ...] target 
In file 1 [ files ...] target 
mv filel [ files ...] target 

DESCRIPTION 

Filel is copied (linked, moved) to target. Under no circumstance can 
filel and target be the same. If target is a directory, then one or more 
files are copied (linked, moved) to that directory. 

If mv determines that the mode of target forbids writing, it will print the 
mode (see chmod{2)) and read the standard input for one line (if the 
standard input is a terminal): if the line begins with y. the move takes 
place; if not. mv exits. 

Only mv will allow filel to be a directory, in which case the directory 
rename will occur only if the two directories have the same parent. 

SEE ALSO 

cpio(l). link(8). rm(l). chmod(S). 

BUGS 

If filel and target lie on different file systems, mv must copy the file and 
delete the original. In this case the owner name becomes that of the 
copying process and any linking relationship with other files is lost. 

Ln will not link across file systems. 
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NAME 

cpio — copy file archives in and out 

SYNOPSIS 

cpio —o [ acBSv ] 

cpio —i [ BScdmrtuvfshbS ] [ patterns ] 
cpio —p [ adlniruv ] directory 
DESCRIPTION 

Cpio —o (copy out) reads the standard input to obtain a list of path 
names and copies those files onto the standard output together with 
path name and status information. 

Cpio —i (copy in) extracts files from the standard input which is assumed 
to be the product of a previous cpio —o. Only files with names that match 
patterns are selected. Patterns are given in the name-generating nota¬ 
tion of s/i(l). In patterns, meta-characters ?, •, and [...] match the slash 
/ character. Multiple patterns may be specified and if no patterns are 
specified, the default lor patterns is ♦ (i.e., select all files). The extracted 
files are conditionally created and copied into the current directory tree 
based upon the options described below. 

Cpio —p (pass) reads the standard input to obtain a list of path names of 
files that are conditionally created and copied into the destination direc¬ 
tory tree based upon the options described below. 

The meanings of the available options are: 

a Reset access times of input files after they have been copied. 

B Input/output is to be blocked 5,120 bytes to the record (does not 

apply to the pass option; meaningful only with data directed to or 
from /dev/rmt?). 

5 Input/output is to be blocked 61,440 bytes to the record (does not 
apply to the pass option; meaningful for streaming tapes, e.g. 
/dev/rstO). 

d Directories are to be created as needed. 

c Write header information in ASCII character form for portability, 

r Interactively rename files. If the user types a null line, the file is 

skipped. 

t Print a table of contents of the input. No files are created, 

u Copy unconditionally (normally, an older file will not replace a 

newer file with the same name). 

V Verbose: causes a list of file names to be printed. When used with 
the t option, the table of contents looks like the output of an Is —1 
command (see fs(l)). 

1 Whenever possible, link files rather than copying them. Usable 
only with the —p option. 

m Retain previous file modification time. This option is ineffective on 
directories that are being copied, 
f Copy in all files except those in patterns, 

s Swap bytes. Use only with the —i option, 

h Swap halfwords. Use only with the —i option, 

b Swap both bytes and halfwords. Use only with the —i option. 

6 Process an old (i.e., UNIX System Sixth Edition format) file. Only 
useful with —i (copy in). 
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EXAMPLES 

The first example below copies the contents of a directory into an 
archive: the second duplicates a directory hierarchy: 

Is 1 cpio -o >/dev/mtO 
cd olddir 

find . -depth -print I cpio -pdl newdir 

The trivial case “find . -depth -print 1 cpio -oB >/dev/rmtO'’ can be 
handled more efficiently by: 

find . —cpio /dev/rmtO 

SEE ALSO 

ar(l). find(l), cpio(5). 

BUGS 

Path names are restricted to 120 characters. If there are too many 
unique linked files, the program runs out of memory to keep track of 
them and, thereafter, linking information is lost. Only the super-user 
can copy special files. 
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NAME 

cpp - the C language preprocessor 
SYNOPSIS 

/lib/cpp [ option ... ] [ ifile [ ofile ] ] 

DESCRIPTION 

Cpp is the C language preprocessor which is invoked as the first pass of 
any C compilation using the cc(l) comjnand. Thus the output of cpp is 
designed to be in a form acceptable as input to the next pass of the C 
compiler. As the C language evolves, cpp and the rest of the C compila¬ 
tion package will be modified to follow these changes. Therefore, the use 
of cpp other than in this framework is not suggested. The preferred way 
to invoke cpp is through the cc(l) command since the functionality of 
cpp may someday be moved elsewhere. See m4{l) for a general macro 
processor. 

Cpp optionally accepts two file names as arguments. Ifile and ofile are 
respectively the input and output for the preprocessor. They default to 
standard input and standard output if not supplied. 

The following options to cpp are recognized: 

—P Preprocess the input without producing the line control informa¬ 

tion used by the next pass of the C compiler. 

—C By default, cpp strips C-style comments. If the —C option is 

specified, all comments (except those found on cpp directive lines) 
are passed along. 

—Uname 

Remove any initial definition of name, where name is a reserved 
symbol that is predefined by the particular preprocessor. The 
current list of these possibly reserved symbols includes: 
operating system: ibm, geos, os, tss, unix 
hardware: interdata, pdpll, u370, u3b, vax 

UNIX System variant: 

RES. RT 

—I>name 
—I>na7ne=de/ 

Define name as if by a ijldefine directive. If no =def is given, name 
is defined as 1. 

—Idir Change the algorithm for searching for ^include files whose names 
do not begin with / to look in dir before looking in the directories 
on the standard list. Thus, ^(include files whose names are 
enclosed in "" will be searched for first in the directory of the ifile 
argument, then in directories named in —I options, and last in 
directories on a standard list. For ^include files whose names are 
enclosed in <>, the directory of the ifile argument is not 
searched. 

Two special names are understood by cpp. The name_^LINE-is 

defined as the current line number (as a decimal integer) as known by 

cpp, and_FILE__is defined as the current file name (as a C string) as 

known by cpp. They can be used anywhere (including in macros) just as 
any other defined name. 
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All cpp directives start with lines begun by #. The directives are: 


{^define name token-string 

Replace subsequent instances of name with token-string. 

#define name{ arg . arg ) token-string 

Notice that there can be no space between name and the (. 
Replace subsequent instances of name followed by a (, a list of 
comma separated tokens, and a ) by token-string where each 
occurrence of an arg in the token-string is replaced by the 
corresponding token in the comma separated list. 

jl^iindef name 

Cause the definition of name (if any) to be forgotten from now on. 


)|(include ''filename" 
include <filename> 

Include at this point the contents of filename (which will then be 
run through cpp). When the <filename> notation is used. 
filename is only searched for in the standard places. See the -I 
option above for more detail. 

)|(line integer-constant "filename" 

Causes cpp to generate line control information for the next pass 
of the C compiler, integer-constant is the line number of the next 
line and filename is the file where it comes from. If "filename" is 
not given, the current file name is unchanged. 

§endif 

Ends a section of lines begun by a test directive (#if, #ifdef. or 
#ifndef). Each test directive must have a matching #endif. 

)i(ifdef name 

The lines following will appear in the output if and only if name 
has been the subject of a previous #define without being the sub¬ 
ject of an intervening #undef. 

#ifndef name 

The lines following will not appear in the output if and only if 
name has been the subject of a previous jjfdefine without being the 
subject of an intervening #undef. 

jjlif constant-expression 

Lines following will appear in the output if and only if the 
constant-expression evaluates to non-zero. All binary non¬ 
assignment C operators, the ?: operator, the unary !, and ~ 
operators are all legal in constant-expression. The precedence of 
the operators is the same as defined by the C language. There is 
also a unary operator defined, which can be used in constant- 
expression in these two forms: defined ( name ) or defined name. 
This allows the utility of #ifdef and #ifndef in a #if directive. Only 
these operators, integer constants, and names which are known by 
cpp should be used in constant-expression. In particular, the 
sizeof operator is not available. 

#else Reverses the notion of the test directive which matches this direc¬ 
tive. So if lines previous to this directive are ignored, the following 
lines will appear in the output. And vice versa. 
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The test directives and the possible ji^else directives can be nested. 

FILES 

/usr/include standard directory for ^include files 

SEE ALSO 

cc(l), m4(l). 

DIAGNOSTICS 

The error messages produced by cpp are intended to be self-explanatory. 
The line number and filename where the error occurred are printed 
along with the diagnostic. 

NOTES 

When newline characters were found in argument lists for macros to be 
expanded, previous versions of cpp put out the newlines as they were 
found and expanded. The current version of cpp replaces these newlines 
with blanks to alleviate problems that the previous versions had when 
this occurred. 
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NAME 

create — create a file 

SYNOPSIS 

create file... 

DESCRIPTION 

Create creates one or more files named file... with a length of 
This is written as a shell procedure and should really give you 
when you read it. 



bytes. 

laugh 
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NAME 

cref — make cross-reference listing 
SYNOPSIS 

cref [ —acilnostuxl23 ] files 
DESCRIPTION 

Cref makes a cross-reference listing of assembler or C programs: files 
are searched for symbols in the appropriate syntax. 

The output report is in four columns: 

1. symbol: 

2. file name: 

3. see below: 

4. text as it appears in the file. 

Cref uses either dn ignore file or an only file. If the —i option is given, 
the next argument is taken to be an ignore file: if the -o option is given, 
the next argument is taken to be an only file. Ignore and only files are 
lists of symbols separated by new-lines. All symbols in an ignore file are 
ignored in columns 1 and 3 of the output. If an only file is given, only 
symbols in that file will appear in column 1. Only one of these options 
may be given: the default setting is —i using the default ignore file (see 
FILES below). Assembler pre-defined symbols or C keywords are ignored. 

The —s option causes current symbols to be put in column 3. In the 
assembler, the current symbol is the most recent name symbol: in C. the 
current function name. The —1 option causes the line number within the 
file to be put in column 3. 

The —t option causes the next available argument to be used as the name 
of the intermediate file (instead of the temporary file /trap/crt??). This 
file is created and is not removed at the end of the process. 

The cref options are: 

a assembler format (default) 
c C format input 
i use an ignore file (see above) 

1 put line number in column 3 (instead of current symbol) 
n omit column 4 (no context) 
o use an only file (see above) 
s current symbol in column 3 (default) 
t user-supplied temporary file 
u print only symbols that occur exactly once 
X print only C external symbols 

1 sort output on column 1 (default) 

2 sort output on column 2 

3 sort output on column 3. 

FILES 

/tmp/crt?? temporaries 
/usr/lib/cref/aign 

default assembler ignore file 
/ u sr / lib / cref / atab 

grammar table for assembler files 
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/usr/lib/cref /cign 

default C ignore file 
/usr/lib/cref/ctab 

grammar table for C files 
/usr/lib/cref/crpost 

post-processor 
/usr/lib/cref /upost 

post-processor for —u option 

SEE ALSO 

as(l). cc(l), sort(l). xref(l). 

BUGS 

Cref inserts an ASCII DEL character into the intermediate file after the 
eighth character of each name that is eight or more characters long in 
the source file. 
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NAME 

crypt — encode/decode 
SYNOPSIS 

crypt [ password ] 

DESCRIPTION 

Crypt reads from the standard input and writes on the standard output. 
The password is a key that selects a particular transformation. If no 
password is given, crypt demands a key from the terminal and turns off 
printing while the key is being typed in. Crypt encrypts and decrypts 
with the same key: 

crypt key <clear >cypher 
crypt key <cypher | pr 

will print the clear. 

Files encrypted by crypt are compatible with those treated by the editor 
ed in encryption mode. 

The security of encrypted files depends on three factors: the fundamen¬ 
tal method must be hard to solve; direct search of the key space must be 
infeasible; 'sneak paths’ by which keys or cleartext can become visible 
must be minimized. 

Crypt implements a one-rotor machine designed along the lines of the 
German Enigma, but with a 256-element rotor. Methods of attack on 
such machines are known, but not widely; moreover the amount of work 
required is likely to be large. 

The transformation of a key into the internal settings of the machine is 
deliberately designed to be expensive, i.e. to take a substantial fraction 
of a second to compute. However, if keys are restricted to (say) three 
lower-case letters, then encrypted files can be read by expending only a 
substantial fraction of five minutes of machine time. 

Since the key is an argument to the crypt command, it is potentially visi¬ 
ble to users executing ps(l) or a derivative. To minimize this possibility, 
crypt takes care to destroy any record of the key immediately upon 
entry. No doubt the choice of keys and key security are the most vulner¬ 
able aspect of crypt. 

FILES 

/dev/tty for typed key 
SEE ALSO 

ed(l). makekey(0) 

BUGS 

There is no warranty of merchantability nor any warranty of fitness for a 
particular purpose nor any other warranty, either express or implied, as 
to the accuracy of the enclosed materials or as to their suitability for 
any particular purpose. Accordingly, Bell Telephone Laboratories 
assumes no responsibility for their use by the recipient. Further, Bell 
Laboratories assumes no obligation to furnish any assistance of any kind 
whatsoever, or to furnish any additional information or documentation. 
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NAME 

csh - a shell (command interpreter) with C-like syntax 
SYNOPSIS 

csh [ —cefinstvVxX ] [ arg ... ] 

DESCRIPTION 

Csh is a first implementation of a command language interpreter incor¬ 
porating a history mechanism (see History Substitutions) and a C-like 
syntax. 

An instance of csh begins by executing commands from the file ‘.cshrc’ in 
the home directory of the invoker. If this is a login shell then it also exe¬ 
cutes commands from the file ‘.login* there. It is typical for users on 
crt’s to put the command "stty crt" in their .login file, and to also invoke 
tabs{l) there. 

In the normal case, the shell will then begin reading commands from the 
terminal, prompting with '% ’. Processing of arguments and the use of 
the shell to process files containing command scripts will be described 
later. 

The shell then repeatedly performs the following actions: a line of com¬ 
mand input is read and broken into words. This sequence of words is 
placed oh the command history list and then parsed. Finally each com¬ 
mand in the current line is executed. 

When a login shell terminates it executes commands from the file 
‘.logout’ in the users home directory. 

Lexical structure 

The shell splits input lines into words at blanks and tabs with the follow¬ 
ing exceptions. The characters 'Sc' ‘|‘ '<* '>’ *(’ •)* form separate words. 

If doubled in ‘(kA:’, ‘| |‘, ‘<<‘ or ‘>>‘ these pairs form single words. These 
parser metacharacters may be made part of other words, or prevented 
their special meaning, by preceding them with ‘\’. A newline preceded by 
a ‘\ ’ is equivalent to a blank. 

In addition strings enclosed in matched pairs of quotations. *'* or 
form parts of a word; metacharacters in these strings, including blanks 
and tabs, do not form separate words. These quotations have semantics 
to be described subsequently. Within pairs of or "" characters a new- 
line preceded by a ‘\ ’ gives a true newline character. 

When the shell’s input is not a terminal, the character introduces a 
comment which continues to the end of the input line. It is prevented 
this special meaning when preceded by ‘\ ’ and in quotations using 
and 

Commands 

A simple command is a sequence of words, the first of which specifies the 
command to be executed. A simple command or a sequence of simple 
commands separated by ‘|‘ characters forms a pipeline. The output of 
each command in a pipeline is connected to the input of the next. 
Sequences of pipelines may be separated by and are then executed 
sequentially. A sequence of pipelines may be executed without immedi¬ 
ately waiting for it to terminate by following it with an ’&’. 
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Any of the above may be placed in ‘(’ ')’ to form a simple command (which 
may be a component of a pipeline, etc.) It is also possible to separate 
pipelines with 'I 1' or 'ScSc' indicating, as in the C language, that the second 
is to be executed only if the first fails or succeeds respectively. (See 
Expressions.) 

Jobs 

The shell associates a job with each pipeline. It keeps a table of current 
jobs, printed by the jobs command, and assigns them small integer 
numbers. When a job is started asynchronously with the shell prints 
a line which looks like; 

[1] 1234 

indicating that the jobs which was started asynchronously was job 
number 1 and had one (top-level) process, whose process id was 1234. 

A job being run in the background will stop if it tries to read from the 
terminal. Background jobs are normally allowed to produce output, but 
this can be disabled by giving the command ‘‘stty tostop”. If you set this 
tty option, then background jobs will stop when they try to produce out¬ 
put like they do when they try to read input. 

The shell maintains a notion of the current and previous jobs. In output 
pertaining to jobs, the current job is marked with a ' + ’ and the previous 
job with a The abbreviation '%+’ refers to the current job and ' 
refers to the previous job. For close analogy with the syntax of the his¬ 
tory mechanism (described below), '%%’ is also a synonym for the current 
job. 

Status reporting 

This shell learns immediately whenever a process changes state. It nor¬ 
mally informs you whenever a job becomes blocked so that no further 
progress is possible, but only just before it prints a prompt. This is done 
so that it does not otherwise disturb your work. If, however, you set the 
shell variable notify, the shell will notify you immediately of changes of 
status in background jobs. There is also a shell command notify which 
marks a single process so that its status changes will be immediately 
reported. By default notify marks the current process; simply say 
'notify' after starting a background job to mark it. 

Substitutions 

We now describe the various transformations the shell performs on the 
input in the order in which they occur. 

History substitutions 

History substitutions place words from previous command input as por¬ 
tions of new commands, making it easy to repeat commands, repeat 
arguments of a previous command in the current command, or fix spel¬ 
ling mistakes in the previous command with little typing and a high 
degree of confidence. History substitutions begin with the character '!’ 
and may begin anywhere in the input stream (with the provison that they 
do not nest.) This '!’ may be preceded by an '\' to prevent its special 
meaning; for convenience, a '!' is passed unchanged when it is followed by 
a blank, tab, newline, '=’ or '(’. (History substitutions also occur when an 
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input line begins with *t'. This special abbreviation will be described 
later.) Any input line which contains history substitution is echoed on 
the terminal before it is executed as it could have been typed without 
history substitution. 

Commands input from the terminal which consist of one or more words 
are saved on the history list. The history substitutions reintroduce 
sequences of words from these saved commands into the input stream. 
The size of which is controlled by the history variable; the previous com¬ 
mand is always retained, regardless of its value. Commands are num¬ 
bered sequentially from 1. 

For definiteness, consider the following output from the history com¬ 
mand; 

9 write michael 

10 ex write.c 

11 cat oldwrite.c 

12 difT *write.c 

The commands are shown with their event numbers. It is not usually 
necessary to use event numbers, but the current event number can be 
made part of ihe prompt by placing an '!’ in the prompt string. 

With the current event 13 we can refer to previous events by event 
number '!11’, relatively as in ‘!—2’ (referring to the same event), by a 
prefix of a command word as in '!d’ for event 12 or ’Iwri' for event 9, or by 
a string contained in a word in the command as in '!?mic?’ also referring 
to event 9. These forms, without further modification, simply reintro¬ 
duce the words of the specified events, each separated by a single blank. 
As a special case *!!’ refers to the previous command: thus '!!’ alone is 
essentially a redo. 

To select words from an event we can follow the event specification by a 
and a designator for the desired words. The words of a input line are 
numbered from 0, the first (usually command) word being 0, the second 
word (first argument) being 1, etc. The basic word designators are: 

0 first (command) word 

n n 'th argument 

t first argument, i.e. *1’ 

S last argument 

% word matched by (immediately preceding) ?s? search 

x—y range of words 

—y abbreviates'0—y ’ 

• abbreviates ‘t—S', or nothing if only 1 word in event 

X* abbreviates ‘x—$’ 

X— like 'x*' but omitting word 'S' 

The ':' separating the event specification from the word designator can 
be omitted if the argument selector begins with a 'f, 'S', ’ or '%’. 

After the optional word designator can be placed a sequence of modifiers, 
each preceded by a The following modifiers are defined: 

h Remove a trailing pathname component, leaving the head, 

r Remove a trailing '.xxx' component, leaving the root name, 

e Remove all but the extension '.xxx' part. 
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s/i /r / Substitute I for r 

t Remove all leading pathname components, leaving the tail. 

& Repeat the previous substitution. 

g Apply the change globally, prefixing the above, e.g. 'git'. 

p Print the new command but do not execute it. 

q Quote the substituted words, preventing further substitutions. 

X Like q, but break into words at blanks, tabs and newlines. 

Unless preceded by a ‘g’- the modification is applied only to the first 
modifiable word. With substitutions, it is an error for no word to be appli¬ 
cable. 

The left hand side of substitutions are not regular expressions in the 
sense of the editors, but rather strings. Any character may be used as 
the delimiter in place of V; a ‘X’ quotes the delimiter into the L and r 
strings. The character 'k.' in the right hand side is replaced by the text 
from the left. A ’X’ quotes *&’ also. A null I uses the previous string 
either from a f or from a contextual scan string s in ■!?s?'. The trailing 
delimiter in the substitution may be omitted if a newline follows immedi¬ 
ately as may the trailing '?’ in a contextual scan. 

A history reference may be given without an event specification, e.g. ‘!S’. 

In this case the reference is to the previous command unless a previous 
history reference occurred on the same line in which case this form 
repeats the previous reference. Thus ’!?foo?'r !S’ gives the first and last 
arguments from the command matching ‘?foo?’. 

A special abbreviation of a history reference occurs when the first non¬ 
blank character of an input line is a ‘f. This is equivalent to ■!:st’ provid¬ 
ing a convenient shorthand for substitutions on the text of the previous 
line. Thus ‘tlbtlib’ fixes the spelling of Tib' in the previous command. 
Finally, a history substitution may be surrounded with and ’j’ if neces¬ 
sary to insulate it from the characters which follow. Thus, after 'Is —Id 
"“pauT we might do '!jlja' to do 'Is —Id ~paula’, while '!la' would look for a 
command starting Ta’. 

Quotations with ' and " 

The quotation of strings by and can be used to prevent all or some 
of the remaining substitutions. Strings enclosed in are prevented any 
further interpretation. Strings enclosed in "" are yet variable and com¬ 
mand expanded as described below. 

In both cases the resulting text becomes (all or part of) a single word; 
only in one special case (see Command ^bstitition below) does a 
quoted string yield parts of more than one word; quoted strings never 
do. 

Alias substitution 

The shell maintains a list of aliases which can be established, displayed 
and modified by the alias and unalias commands. After a command line 
is scanned, it is parsed into distinct commands and the first word of each 
command, left-to-right, is checked to see if it has an alias. If it does, 
then the text which is the alias for that command is reread with the his¬ 
tory mechanism available as though that command were the previous 
input line. The resulting words replace the command and argument list. 
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If no reference is made to the history list, then the argument list is left 
unchanged. 

Thus if the alias for ‘Is’ is 'Is —1’ the command ‘Is /usr' would map to ‘Is —1 
/usr', the argument list here being undisturbed. Similarly if the alias for 
‘lookup‘ was ‘grep !t /etc/passwd’ then ‘lookup bill’ would map to ‘grep 
bill /etc/passwd’. 

If an alias is found, the word transformation of the input text is per¬ 
formed and the aliasing process begins again on the reformed input line. 
Looping is prevented if the first word of the new text is the same as the 
old by flagging it to prevent further aliasing. Other loops are detected 
and cause an error. 

Note that the mechanism allows aliases to introduce parser metasyntax. 
Thus we can ‘alias print 'pr \!* | lpr'‘ to make a command which pr's its 
arguments to the line printer. 

Variable substitution 

The shell maintains a set of variables, each of which has as value a list of 
zero or more words. Some of these variables are set by the shell or 
referred to by it. For instance, the argv variable is an image of the 
shell’s argument list, and words of this variable’s value are referred to in 
special ways. 

The values of variables may be displayed and changed by using the set 
and unset commands. Of the variables referred to by the shell a number 
are toggles; the shell does not care what their value is, only whether they 
are set or not. For instance, the verbose variable is a toggle which causes 
command input to be echoed. The setting of this variable results from 
the —T command line option. 

Other operations treat variables numerically. The ‘@’ command permits 
numeric calculations to be performed and the result assigned to a vari¬ 
able. Variable values are, however, always represented as (zero or more) 
strings. For the purposes of numeric operations, the null string is con¬ 
sidered to be zero, and the second and subsequent words of multiword 
values are ignored. 

After the input line is aliased and parsed, and before each conunand is 
executed, variable substitution is performed keyed by ’S’ characters. 
This expansion can be prevented by preceding the ‘S’ with a ‘\ ’ except 
within ""s where it always occurs, and within ‘'‘s where it never occurs. 
Strings quoted by ‘'’ are interpreted later (see Command substitution 
below) so ‘S’ substitution does not occur there until later, if at all. A ‘S’ 
is passed unchanged if followed by a blank, tab. or end-of-line. 

Input/output redirections are recognized before variable expansion, and 
are variable expanded separately. Otherwise, the command name and 
entire argument list are expanded together. It is thus possible for the 
first (command) word to this point to generate more than one word, the 
first of which becomes the command name, and the rest of which become 
arguments. 

Unless enclosed in or given the ‘:q’ modifier the results of variable sub¬ 
stitution may eventually be command and filename substituted. Within 
a variable whose value consists of multiple words expands to a 
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(portion of) a single word, with the words of the variables value separated 
by blanks. When the ‘:q’ modifier is applied to a substitution the variable 
will expand to multiple words with each word separated by a blank and 
quoted to prevent later command or filename substitution. 

The following metasequences are provided for introducing variable values 
into the shell input. Except as noted, it is an error to reference a vari¬ 
able which is not set. 

Sname 

S(namej 

Are replaced by the words of the value of variable name, each 
separated by a blank. Braces insulate name from following charac¬ 
ters which would otherwise be part of it. Shell variables have names 
consisting of up to 20 letters and digits starting with a letter. The 
underscore character is considered a letter. 

If name is not a shell variable, but is set in the environment, then 
that value is returned (but : modifiers and the other forms given 
below are not available in this case). 

Sname[selector] 

S{name[selector] J 

May be used to select only some of the words from the value of 
name. The selector is subjected to ‘S' substitution and may consist 
of a single number or two numbers separated by a The first word 
of a variables value is numbered *1’. If the first number of a range is 
omitted it defaults to If the last member of a range is omitted it 
defaults to ‘S^name’. The selector selects all words. It is not an 
error for a range to be empty if the second argument is omitted or 
in range. 

S#name 

Sj#name| 

Gives the number of words in the variable. This is useful for later 
use in a ‘[selector]’. 

SO 

Substitutes the name of the file from which command input is being 
read. An error occurs if the name is not known. 

Snumber 

Sjnumberj 

Equivalent to 'Sargv[number]’. 

S* 

Equivalent to ■Sargv[*]'. 

The modifiers ’;h’. ■;t’. ‘ir’, ‘iq’ and ‘:x’ may be applied to the substitutions 
above as may 'tgh', ':gt’ and ■:gr'. If braces ‘j’ ‘j’ appear in the command 
form then the modifiers must appear within the braces. The current 
implementation ailows only one modifier on each ‘S' expansion. 

The following substitutions may not be modified with modifiers. 

S?name 

S|?namej 

Substitutes the string T if name is set. ‘O' if it is not. 
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s?o 

Substitutes '1' if the current input filename is known, ’0' if it is not. 

$8 

Substitute the (decimal) process number of the (parent) shell. 

S< 

Substitutes a line from the standard input, with no further interpre¬ 
tation thereafter. It can be used to read from the keyboard in a 
shell script. 

Command and filename substitution 

The remaining substitutions, command and filename substitution, are 
applied selectively to the arguments of builtin commands. This means 
that portions of expressions which are not evaluated are not subjected to 
these expansions. For commands which are not internal to the shell, the 
command name is substituted separately from the argument list. This 
occurs very late, after input-output redirection is performed, and in a 
child of the main shell. 

Command substitution 

Command substitution is indicated by a command enclosed in The 
output from such a command is normally broken into separate words at 
blanks, tabs and newlines, with null words being discarded, this text then 
replacing the original string. Within ‘"’s. only newlines force new words; 
blanks and tabs are preserved. 

In any case, the single final newline does not force a new word. Note that 
it is thus possible for a command substitution to yield only part of a 
word, even if the command outputs a complete line. 

Filename substitution 

If a word contains any of the characters ‘?’, ‘[’ or or begins with the 
character then that word is a candidate for filename substitution, 
also known as 'globbing’. This word is then regarded as a pattern, and 
replaced with an alphabetically sorted list of file names which match the 
pattern. In a list of words specifying filename substitution it is an error 
for no pattern to match an existing file name, but it is not required for 
each pattern to match. Only the metacharacters *•’, '?' and ’[’ imply pat¬ 
tern matching, the characters and ’(' being more akin to abbrevia¬ 
tions. 

In matching filenames, the character at the beginning of a filename or 
immediately following a '/', as well as the character '/’ must be matched 
explicitly. The character matches any string of characters, including 
the null string. The character *?' matches any single character. The 
sequence matches any one of the characters enclosed. Within 
a pair of characters separated by ’ matches any character lexically 
between the two. 

The character at the beginning of a filename is used to refer to home 
directories. Standing alone, i.e. it expands to the invokers home 
directory as reflected in the value of the variable home. When followed by 
a name consisting of letters, digits and ’ characters the shell searches 
for a user with that name and substitutes their home directory; thus 
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'~ken’ might expand to Vusr/ken' and ’^ken/chmach’ to 
'/usr/ken/chmach'. If the character is followed by a character other 
than a letter or V’ or appears not at the beginning of a word, it is left 
undisturbed. 

The metanotation ’a(b,c,dje' is a shorthand for 'abe ace ade'. Left to 
right order is preserved, with results of matches being sorted separately 
at a low level to preserve this order. This construct may be nested. Thus 
•~source/sl/(oldls,ls}.c’ expands to Vusr/source/sl/oldls.c 
/usr/source/sl/Is.c' whether or not these files exist without any chance 
of error if the home directory for ’source' is ’/usr/source’. Similarly 
‘.y{memo,*boxj’ might expand to ’../memo ../box ../mbox’. (Note that 
’memo’ was not sorted with the results of matching ’•box’.) As a special 
case ■{’, ’j’ and ‘(j' are passed undisturbed. 

Input/output 

The standard input and standard output of a command may be 
redirected with the following syntax: 

< name 

Open file name (which is first variable, command and filename 
expanded) as the standard input. 

<< word 

Read the shell input up to a line which is identical to word. Word is 
not subjected to variable, filename or command substitution, and 
each input line is compared to word before any substitutions are 
done on this input line. Unless a quoting 'X’, or appears in 

word variable and command substitution is performed on the inter¬ 
vening lines, allowing ’\ ’ to quote ‘S', '\’ and Commands which 
are substituted have all blanks, tabs, and newlines preserved, except 
for the final newline which is dropped. The resultant text is placed 
in an anonymous temporary file which is given to the command as 
standard input. 

> name 
>! name 
>& name 
>&! name 

The file name is used as standard output. If the file does not exist 
then it is created: if the file exists, its is truncated, its previous con¬ 
tents being lost. 

If the variable noclobber is set. then the file must not exist or be a 
character special file (e.g. a terminal or ’/dev/nuH’) or an error 
results. This helps prevent accidental destruction of files. In this 
case the ‘!' forms can be used and suppress this check. 

The forms involving route the diagnostic output into the specified 
file as well as the standard output. Name is expanded in the same 
way as '<■ input filenames are. 

» name 
>>& name 
>>! name 
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>>(5c! name 

Uses file name as standard output like ’>’ but places output at the 
end of the file. If the variable noclobber is set, then it is an error for 
the file not to exist unless one of the '!’ forms is given. Otherwise 
similar to ■>'. 

A command receives the environment in which the shell was invoked as 
modified by the input-output parameters and the presence of the com¬ 
mand in a pipeline. Thus, unlike some previous shells, commands run 
from a file of shell commands have no access to the text of the com¬ 
mands by default: rather they receive the original standard input of the 
shell. The '<<’ mechanism should be used to present inline data. This 
permits shell command scripts to function as components of pipelines 
and allows the shell to block read its input. Note that the default stan¬ 
dard input for a command run detached is not modified to be the empty 
file Vdev/null’; rather the standard input remains as the original stan¬ 
dard input of the shell. If this is a terminal and if the process attempts 
to read from the terminal, then the process will block and the user will 
be notified (see Jobs above.) 

Diagnostic output may be directed through a pipe with the standard out¬ 
put. Simply use the form ‘|(Sc’ rather than just ’I'. 

Expressions 

A number of the builtin commands (to be described subsequently) take 
expressions, in which the operators are similar to those of C, with the 
same precedence. These expressions appear in the exit, if, and while 
commands. The following operators are available: 

I I && I t (Sc ==!= =~ !~ <=>=<>«>> + -•/%! ~ 

( ) 

Here the precedence increases to the right, *= = ’ *!=’ '=~’ and '<=' 
•> = ’ ■<’ and •>’, ■<<’ and *>>’, ’+’ and "/' and ■%’ being, in groups, at 

the same level. The ■==’ ’!=' and operators compare their argu¬ 
ments as strings; all others operate on numbers. The operators and 
are like ’!=’ and ’==’ except that the right hand side is a pattern 
(containing, e.g. ‘‘’s, ‘?’s and instances of '[...]’) against which the left 
hand operand is matched. This reduces the need for use of the switch 
statement in shell scripts when all that is really needed is pattern match¬ 
ing. 

Strings which begin with ‘0’ are considered octal numbers. Null or miss¬ 
ing arguments are considered 'O’. The result of all expressions are 
strings, which represent decimal numbers. It is important to note that 
no two components of an expression can appear in the same word; 
except when adjacent to components of expressions which are syntacti¬ 
cally significant to the parser {'it' '1' '<’ *>’ '(’ ')’) they should be sur¬ 
rounded by spaces. 

Also available in expressions as primitive operands are command execu¬ 
tions enclosed in and ‘j’ and file enquiries of the form '—I name’ where 
I is one of; 

r read access 

w write access 
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X execute access 
e existence 

o ownership 

z zero size 

f plain file 

d directory 

The specified name is command and filename expanded and then tested 
to see if it has the specified relationship to the real user. If the file does 
not exist or is inaccessible then all enquiries return false, i.e. ‘O'. Com¬ 
mand executions succeed, returning true. i.e. ‘1’, if the command exits 
with status 0, otherwise they fail, returning false, i.e. ‘O’. If more detailed 
status information is required then the command should be executed 
outside of an expression and the variable status examined. 

Control flow 

The shell contains a number of commands which can be used to regulate 
the flow of control in command files (shell scripts) and (in limited but 
useful ways) from terminal input. These commands all operate by forc¬ 
ing the shell to reread or skip in its input and, due to the implementa¬ 
tion, restrict the placement of some of the commands. 

The foreach, switch, and while statements, as well as the if—then—else 
form of the if statement require that the major keywords appear in a 
single simple command on an input line as shown below. 

If the shell’s input is not seekable, the shell buffers up input whenever a 
loop is being read and performs seeks in this internal buffer to accom¬ 
plish the rereading implied by the loop. (To the extent that this allows, 
backward goto’s will succeed on non-seekable inputs.) 

Builtin commands 

Builtin commands are executed within the shell. If a builtin command 
occurs as any component of a pipeline except the last then it is executed 
in a subshell. 

alias 

alias name 

alias name wordlist 

The first form prints all aliases. The second form prints the alias for 
name. The final form assigns the specified wordlist as the alias of 
name; wordlist is command and filename substituted. Name is not 
allowed to be alias or unalias. 

break 

Causes execution to resume after the end of the nearest enclosing 
foreach or while. The remaining commands on the current line are 
executed. Multi-level breaks are thus possible by writing them all on 
one line. 

breaksw 

Causes a break from a switch, resuming after the endsw. 
case label: 

A label in a switch statement as discussed below. 
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cd 

cd name 
chdir 

chdir name 

Change the shells working directory to directory name. If no argu¬ 
ment is given then change to the home directory of the user. 

If name is not found as a subdirectory of the current directory (and 
does not begin with */', *./’ or then each component of the 

variable cdpath is checked to see if it has a subdirectory name. 
Finally, if all else fails but name is a shell variable whose value 
begins with */', then this is tried to see if it is a directory. 

continue 

Continue execution of the nearest enclosing while or foreach. The 
rest of the commands on the current line are executed. 

default: 

Labels the default case in a switch statement. The default should 
come after all case labels. 

dirs 

Prints the directory stack; the top of the stack is at the left, the 
first directory in the stack being the current directory. 

echo wordlist 
echo —n wordlist 

The specified words are written to the shells standard output, 
separated by spaces, and terminated with a newline unless the —n 
option is specified. 

else 

end 

endif 

endsw 

See the description of the foreach, if, switch, and while statements 
below. 

eval arg ... 

(As in sh{l).) The arguments are read as input to the shell and the 
resulting command(s) executed. This is usually used to execute 
commands generated as the result of command or variable substitu¬ 
tion. since parsing occurs before these substitutions. See tset{l) for 
an example of using eval. 

exec command 

The specified command is executed in place of the current shell. 

exit 

exit(expr) 

The shell exits either with the value of the status variable (first 
form) or with the value of the specified expr (second form). 

foreach name (wordlist) 
end 

The variable name is successively set to each member of wordlist 
and the sequence of commands between this command and the 
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matching end are executed. (Both foreach and end must appear 
alone on separate lines.) 

The builtin command continue may be used to continue the loop 
prematurely and the builtin command break to terrninate it prema¬ 
turely. When this command is read from the terminal, the loop is 
read up once prompting with ’?' before any statements in the loop 
are executed. If you make a mistake typing in a loop at the terminal 
you can rub it out. 

globwordlist j j 

Like echo but no ’X’ escapes are recognized and words are delimited 
by null characters in the output. Useful for programs which wish to 
use the shell to filename expand a list of words. 

goto word j j . • 1 j 

The specified word is filename and command expanded to yield a 
string of the form 'laber. The shell rewinds its input as much as pos¬ 
sible and searches for a line of the form iabel:' possibly preceded by 
blanks or tabs. Execution continues after the specified line. 

hashstat . , u u . ui 

Print a statistics line indicating how effective the internal hash table 

has been at locating commands (and avoiding exec's). An exec is 
attempted for each component of the path where the hash function 
indicates a possible hit, and in each component which does not 
begin with a '/’. 

history 
history n 
history —r n 

history —h n , . » * 

Displays the history event list; if n is given only the n most recent 
events are printed. The -r option reverses the order of printout to 
be most recent first rather than oldest first. The -h option causes 
the history list to be printed without leading numbers. This is used 
to produce files suitable for sourceing using the —h option to source. 

if (expr) command 

If the specified expression evaluates true, then the single commana 
with arguments is executed. Variable substitution on command hap¬ 
pens early, at the same time it does for the rest of the if command. 
Command must be a simple command, not a pipeline, a command 
list, or a parenthesized command list. Input/output redirection 
occurs even if expr is false, when command is not executed (this is a 
bug). 

if (expr) then 

else if (exprS) then 

else 


endif 


If the specified expr is true then the commands to the first else are 
executed; else if expr2 is true then the commands to the second else 
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are executed, etc. Any number of else-if pairs are possible; only one 
endif is needed. The else part is likewise optional. (The words else 
and endif must appear at the beginning of input lines; the if must 
appear alone on its input line or after an else.) 

jobs 
jobs —1 

Lists the active jobs; given the —1 options lists process id's in addi¬ 
tion to the normal information. 

kill %job 

kill —sig %job ... 

kill pid 

kill —sig pid ... 
kUl-l 

Sends either the TERM (terminate) signal or the specified signal to 
the specified jobs or processes. Signals are either given by number 
or by names (as given in /usr/include/signal.h, stripped of the 
prefix "SIG"). The signal names are listed by "kill —1”. There is no 
default, saying just ‘kill’ does not send a signal to the current job. 

limit 

limit resource 

limit resource maximum-use 

Limits the consumption by the current process and each process it 
creates to not individually exceed maximum-use on the specified 
resource. If no maximum-use is given, then the current limit is 
printed; if no resource is given, then all limitations are given. 

Resources controllable currently include cpufime (the maximum 
number of cpu-seconds to be used by each process), filesize (the 
largest single file which can be created), datasize (the maximum 
growth of the data+stack region via sbrk{2) beyond the end of the 
program text), stacksize (the maximum size of the automatically- 
extended stack region), and coredumpsize (the size of the largest 
core dump that will be created). 

The maximum-use may be given as a (fioating point or integer) 
number followed by a scale factor. For all limits other than cputime 
the default scale is 'k' or 'kilobytes’ (1024 bytes); a scale factor of 
‘m’ or 'megabytes’ may also be used. For cputime the default scaling 
is 'seconds’, while 'm’ for minutes or 'h' for hours, or a time of the 
form ’mm;ss’ giving minutes and seconds may be used. 

For both resource names and scale factors, unambiguous prefixes of 
the names suffice. 

login 

Terminate a login shell, replacing it with an instance of /bin/login. 
This is one way to log off, included for compatibility with sh.(l). 

logout 

Terminate a login shell. Especially useful if ignoreeof is set. 

nice 

nice +number 
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nice command 

nice +number command , , x 

The first form sets the nice for this shell to 4. The second form sets 
the nice to the given number. The final two forms run command at 
priority 4 and number respectively. The super-user may specify 
negative niceness by using 'nice —number ...’. Command is always 
executed in a sub-shell, and the restrictions place on commands in 
simple if statements apply. 


nohup 

nohup command 

The first form can be used in shell scripts to cause hangups to be 
ignored for the remainder of the script. The second form causes the 
specified command to be run with hangups ignored. All processes 
detached with are effectively nohup 'ed. 


notify 

notify %job ... , . » 

Causes the shell to notify the user asynchronously when the status 
of the current or specified jobs changes; normally notification is 
presented before a prompt. This is automatic if the shell variable 
notify is set. 

onintr 
onintr — 

onintr label - , 

Control the action of the shell on interrupts. The first form restores 
the default action of the shell on interrupts which is to terminate 
shell scripts or to return to the terminal command input level. The 
second form 'onintr causes all interrupts to be ignored. The final 
form causes the shell to execute a 'goto label when an interrupt is 
received or a child process terminates because it was interrupted. 

In any case, if the shell is running detached and interrupts are being 
ignored, all forms of onintr have no meaning and interrupts con¬ 
tinue to be ignored by the shell and all invoked commands. 

popd 

popd +n w u 

Pops the directory stack, returning to the new top directory. With a 

argument '+n’ discards the nth entry in the stack. The elements of 
the directory stack are numbered from 0 starting at the top. 

pushd 

pushd name 

pushd +n , f 

With no arguments, pushd exchanges the top two elements of tne 
directory stack. Given a name argument, pushd changes to the new 
directory (ala cd) and pushes the old current working directory (as 
in csw) onto the directory stack. With a numeric argument, rotates 
the nth argument of the directory stack around to be the top ele¬ 
ment and changes to it. The members of the directory stack are 
numbered from the top starting at 0. 

rehash 

Causes the internal hash table of the contents of the directories in 
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the path variable to be recomputed. This is needed if new com¬ 
mands are added to directories in the path while you are logged in. 
This should only be necessary if you add commands to one of your 
own directories, or if a systems programmer changes the contents of 
one of the system directories. 

repeat count command 

The specified command which is subject to the same restrictions as 
the command in the one line if statement above, is executed count 
times. 1/0 redirections occur exactly once, even if count is 0. 

set 

set name 

set name=word 

set name[index]=word 

set name=(wordlist) 

The first form of the command shows the value of all shell variables. 
Variables which have other than a single word as value print as a 
parenthesized word list. The second form sets name to the null 
string. The third form sets name to the single word. The fourth form 
sets the index th component of name to word; this component must 
already exist. The final form sets name to the list of words in 
wordlist. In all cases the value is command and filename expanded. 

These arguments may be repeated to set multiple values in a single 
set command. Note however, that variable expansion happens for all 
arguments before any setting occurs. 

setenv name value 

Sets the value of environment variable name to be value, a single 
string. The most commonly used environment variable USER. TERM, 
and PATH are automatically imported to and exported from the csh 
variables user, term, and path; there is no need to use setenv for 
these. 

shift 

shift variable 

The members of argv are shifted to the left, discarding argv{l\. It is 
an error for argv not to be set or to have less than one word as 
value. The second form performs the same function on the specified 
variable. 

sovirce name 
source —h name 

The shell reads commands from name. Source commands may be 
nested; if they are nested too deeply the shell may run out of file 
descriptors. An error in a source at any level terminates all nested 
source commands. Normally input during source commands is not 
placed on the history list; the —h option causes the commands to be 
placed in the history list without being executed. 

switch (string) 
case strl: 

breaksw 
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default: 

breaksw 

case label is successively matched, against the specified stnng 
which is first command and filename expanded. The file metachar¬ 
acters '?’ and may be used in the case labels, which are vari¬ 
able expanded. If none of the labels match before a 'default' label is 
found, then the execution begins after the default label. Each case 
label and the default label must appear at the beginning of a line. 
The command 6reaA:sty causes execution to continue after tne 
endsw. Otherwise control may fall through case labels and default 
labels as in C. If no label matches and there is no default, execution 
continues after the endsw. 

time 

■With no argument, a summary of time used by this shell and its chil¬ 
dren is printed. If arguments are given the specified simpl^e com¬ 
mand is timed and a time summary as described under the fime 
variable is printed. If necessary, an extra shell is created to print 
the time statistic when the command completes. 

umask 

'^^^e^file creation mask is displayed (first form) or set to the specified 
value (second form). The mask is given in octal. Coi^on values for 
the mask are 002 giving all access to the group and read and exe¬ 
cute access to others or 022 giving all access except no write access 
for users in the group or others. 

All aliases whose names match the specified pattern are discarded. 
Thus all aliases are removed by 'unalias It is not an error or 
nothing to be unaliased. 

Use of the internal hash table to speed location of executed pro¬ 
grams is disabled, 
unliinit resource 

Removes the limitation on resource. If no resource is specified, then 
all resource limitations are removed. 

AU variables whose names match the specified pattern are removed. 
Thus all variables are removed by 'unset this has noticeably dis¬ 
tasteful side-effects. It is not an error for nothing to be unset. 

Removes all variables whose name match the specified pattern from 
the-environment. See also the setenv command above and prxn- 
tenv (1). 
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wait 

All background jobs are waited for. It the shell is interactive, then 
an interrupt can disrupt the wait, at which time the shell prints 
names and job numbers of ail jobs known to be outstanding. 

while (expr) 
end 

While the specified expression evaluates non-zero, the commands 
between the while and the matching end are evaluated. Break and 
continue may be used to terminate or continue the loop prema¬ 
turely. (The while and end must appear alone on their input lines.) 
Prompting occurs here the first time through the loop as for the 
foreach statement if the input is a terminal. 

# 

@ name = expr 
@ name[index] = expr 

The first form prints the values of all the shell variables. The second 
form sets the specified name to the value of expr. If the expression 
contains '<’, or '|’ then at least this part of the expression 

must be placed within '(’ •)’• The third form assigns the value of expr 
to the index th argument of name. Both name and its index th com¬ 
ponent must already exist. 

The operators ••=’, •+=', etc are available as in C. The space 
separating the name from the assignment operator is optional. 
Spaces are, however,'mandatory in separating components of expr 
which would otherwise be single words. 

Special postfix ’++’ and '—’ operators increment and decrement 
name respectively, i.e. i++', 

Pre-defined and environment variables 

The following variables have special meaning to the shell. Of these, argv, 
cwd, home, path, prompt, shell and status are always set by the shell. 
Except for cwd and status this setting occurs only at initialization; these 
variables will not then be modified unless this is done explicitly by the 
user. 

This shell copies the environment variable USER into the variable user, 
TERM into term, and HOME into home, and copies these back into the 
environment whenever the normal shell variables are reset. The environ¬ 
ment variable PATH is likewise handled; it is not necessary to worry 
about its setting other than in the file .cshrc as inferior csh processes will 
import the definition of path from the environment, and re-export it if 
you then change it. (It could be set once in the .login except that com¬ 
mands through nef(l) would not see the definition.) 

argv Set to the arguments to the shell, it is from this variable 

that positional parameters are substituted, i.e. ’Si’ is 
replaced by •Sargv[l]’, etc. 

cdpath Gives a list of alternate directories searched to find sub¬ 

directories in chdir commands. 
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cwd 

echo 


histchars 


history 


home 

ignoreeof 

mail 


noclobber 

noglob 

nonomatch 

notify 


The full pathname of the current directory. 

Set when the —x command line option is given. Causes 
each command and its arguments to be echoed just before 
it is executed. For non-builtin commands all expansions 
occur before echoing. Builtin commands are echoed 
before command and filename substitution, since these 
substitutions are then done selectively. 

Can be given a string value to change the characters used 
in history substitution. The first character of its value is 
used as the history substitution character, replacing the 
default character !. The second character of its value 
replaces the character t in quick substitutions. 

Can be given a numeric value to control the size of the his¬ 
tory list. Any command which has been referenced in this 
many events will not be discarded. Too large values of his- 
tory may run the shell out of memory. The last executed 
command is always saved on the history list. 

The home directory of the invoker, initialized from the 
environment. The filename expansion of refers to this 
variable. 

If set the shell ignores end-of-file from input devices which 
are terminals. This prevents shells from accidentally being 
killed by control-D’s. 

The files where the shell checks for mail. This is done after 
each command completion which will result in a prompt, if 
a specified interval has elapsed. The shell says ‘You have 
new mail.’ if the file exists with an access time not greater 
than its modify time. 

If the first word of the value of mail is numeric it specifies 
a different mail checking interval, in seconds, than the 
default, which is 10 minutes. 

If multiple mail files are specified, then the shell says ‘New 
mail in name' when there is mail in the file name. 

As described in the section on Input/output, restrictions 
are placed on output redirection to insure that files are 
not accidentally destroyed, and that ’»' redirections refer 
to existing files. 

If set. filename expansion is inhibited. This is most useful 
in shell scripts which are not dealing with filenames, or 
after a list of filenames has been obtained and further 
expansions are not desirable. 

If set, it is not an error for a filename expansion to not 
match any existing files; rather the primitive pattern is 
returned. It is still an error for the primitive pattern to be 
malformed, i.e. ‘echo [’ still gives an error. 

If set. the shell notifies asynchronously of job completions. 
The default is to rather present job completions just before 
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printing a prompt. 

path Each word of the path variable specifies a directory in 

which commands are to be sought for execution. A null 
word specifies the current directory. If there is no path 
variable then only full path names will execute. The usual 
search path is ’/bin’ and Vusr/bin*, but this may vary 
from system to system. For the super-user the default 
search path is ‘/etc’, ‘/bin’ and ‘/usr/bin’. A shell which is 
given neither the —c nor the —t option will normally hash 
the contents of the directories in the path variable after 
reading .cshrc, and each time the path variable is reset. If 
new commands are added to these directories while the 
shell is active, it may be necessary to give the rehash or 
the commands may not be found. 


prompt 


savehist 


shell 


status 


The string which is printed before each command is read 
from an interactive terminal input. If a *!’ appears in the 
string it will be replaced by the current event number 
unless a preceding ‘\ ’ is given. Default is ’% ’, or ' for the 
super-user. 

is given a numeric value to control the number of entries 
of the history list that are saved in ~/.history when the 
user logs out. Any command which has been referenced in 
this many events will be saved. During start up the shell 
sources "-/.history into the history list enabling history to 
be saved across logins. Too large values of savehist will 
slow down the shell during start up. 

The file in which the shell resides. This is used in forking 
shells to interpret files which have execute bits set, but 
which are not executable by the system. (See the descrip¬ 
tion of Non-buUtin Command Execution below.) Initialized 
to the (system-dependent) home of the shell. 

The status returned by the last command. If it terminated 
abnormally, then 0300 is added to the status. Builtin com¬ 
mands which fail return exit status T, all other builtin 
commands set status 'O’. 


time Controls automatic timing of commands. If set, then any 

command which takes more than this many cpu seconds 
will cause a line giving user, system, and real times and a 
utilization percentage which .is the ratio of user plus sys¬ 
tem times to real time to be printed when it terminates. 

verbose Set by the —v command line option, causes the words of 
each command to be printed after history substitution. 

Non-builtin command execution 

When a command to be executed is found to not be a builtin command 
the shell attempts to execute the command via cxec(2). Each word in the 
variable path names a directory from which the shell will attempt to exe¬ 
cute the command. If it is given neither a —c nor a —t option, the shell 
will hash the names in these directories into an internal table so that it 
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will only try an exec in a directory if there is a possibility that the com¬ 
mand resides there. This greatly speeds command location when a large 
number of directories are present in the search path. If this mechanism 
has been turned off (via unhash), or if the shell was given a —c or —t 
argument, and in any case for each directory component of path which 
does not begin with a the shell concatenates with the given command 
name to form a path name of a file which it then attempts to execute. 

Parenthesized commands are always executed in a subshell. Thus ‘(cd ; 
pwd) ; pwd’ prints the home directory; leaving you where you were (print¬ 
ing this after the home directory), while *cd ; pwd’ leaves you in the home 
directory. Parenthesized commands are most often used to prevent 
chdir from affecting the current shell. 

If the file has execute permissions but is not an executable binary to the 
system, then it is assumed to be a file containing shell commands and a 
new shell is spawned to read it. 

If there is an alias for shell then the words of the alias will be prepended 
to the argument list to form the shell command. The first word of the 
alias should be the full path name of the shell (e.g. ‘SshelT). Note that 
this is a special, late occurring, case of alias substitution, and only allows 
words to be prepended to the argument list without modification. 

Argument list processing 

If argument 0 to the shell is ' then this is a login shell. The flag argu¬ 
ments are interpreted as follows: 

—c Commands are read from the (single) following argument which must 
be present. Any remaining arguments are. placed in argv. 

—e The shell exits if any invoked command terminates abnormally or 
yields a non-zero exit status. 

—f The shell will start faster, because it will neither search for nor exe¬ 
cute commands from the file ‘.cshrc’ in the invokers home directory. 

—i The shell is interactive and prompts for its top-level input, even if it 
appears to not be a terminal. Shells are interactive without this 
option if their inputs and outputs are terminals. 

—n Commands are parsed, but not executed. This may aid in syntactic 
checking of shell scripts. 

—s Command input is taken from the standard input. 

—t A single line of input is read and executed. A ’N’ may be used to 
escape the newline at the end of this line and continue onto another 
line. 

—V Causes the verbose variable to be set, with the effect that command 
input is echoed after history substitution. 

—x Causes the echo variable to be set, so that commands are echoed 
immediately before execution. 

—V Causes the verbose variable to be set even before ‘.cshrc’ is exe¬ 
cuted. 
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—X Is to —X as —V is to —v. 

After processing of flag arguments if arguments remain but none of the 
~c. ~i. —s, or —i options was given the first argument is taken as the 
name of a file of commands to be executed. The shell opens this file, and 
saves its name for possible resubstitution by ’SO’. Since many systems 
use either the standard version 6 or version 7 shells whose shell scripts 
are not compatible with this shell, the shell will execute such a ‘standard’ 
shell if the first character of a script is not a *#’, i.e. if the script does not 
start with a comment. Remaining arguments initialize the variable argv. 

Signal handling 

The shell normally ignores quit signals. Jobs running detached (ie. in the 
background) are immune to signals generated from the keyboard, includ¬ 
ing hangups. Other signals have the values which the shell inherited 
from its parent. The shells handling of interrupts and terminate signals 
in shell scripts can be controlled by onintr. Login shells catch the ter¬ 
minate signal: otherwise this signal is passed on to children from the 
state in the shell's parent. In no case are interrupts allowed when a login 
shell is reading the file ‘.logout’. 

AUTHOR 

William Joy. Job control and directory stack features first implemented 
by J.E. Kulp of I.I.A.S.A, Laxenburg, Austria, with different syntax than 
that used no'' 

FILES 

~/.cshrc 
~/.login 
~/.logout 
/bin/sh 
/tmp/sh* 

/etc/passwd 

LIMITATIONS 

Words can be no longer than 1024 characters. The system limits argu¬ 
ment lists to 10240 characters. The number of arguments to a command 
which involves filename expansion is limited to 1/6’th the number of 
characters allowed in an argument list. Command substitutions may 
substitute no more characters than are allowed in an argument list. To 
detect looping, the shell restricts the number of alias substititutions on 
a single line to 20. 

SEE ALSO 

sh(l), access(2), execve(2), fork(2), killpg(2), pipe(2), sigsys(2), umask(2), 
setrlimit(2), wait{2), intro(3J), sigset(3), tty(4), a.out(5), environ(5). ‘An 
introduction to the C shell’ 

BUGS 

The PCS MUNIX 1.5 port of the cshell has none of the job control primi¬ 
tives such as bg. fg, stop... This is because we do not use the Berkeley sig¬ 
nals which are not in System V Unix. 

When a command is restarted from a stop, the shell prints the directory 
it started in if this is different from the current directory; this can be 
misleading (i.e. wrong) as the job may have changed directories 


Read at beginning of execution by each shell. 

Read by login shell, after ‘.cshrc’ at login. 

Read by login shell, at logout. 

Standard shell, for shell scripts not starting with a 
Temporary file for ’«’. 

Source of home directories for ‘"-name’. 
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internally. 

Shell builtin functions are not stoppable/restartable. Command 
sequences of the form ’a ; b : c* are also not handled gracefully when 
stopping is attempted. If you suspend ‘b’. the shell will then immediately 
execute *c*. This is especially noticeable if this expansion results from an 
alias. It suffices to place the sequence of commands in ()’s to force it to a 
subshell, i.e. ‘( a ; b ; c )’. 


Control over tty output after processes are started is primitive; perhaps 
this will inspire someone to work on a good virtual ter^nal interface. In 
a virtual terminal interface much more interesting things could be done 
with output control. 


Alias substitution is most often used to clumsily simulate shell pro¬ 
cedures; shell procedures should be provided rather than aliases. 

Commands within loops, prompted for by ’?’, are not placed in the history 
list. Control structure should be parsed rather than being recognized as 
built-in commands. This would allow control commands to be placed any¬ 
where, to be combined with *1’. and to be used with 'St' and metasyntax. 

It should be possible to use Ihe modifiers on the output of command 
substitutions. All and more than one modifier should be allowed on ’S' 
substitutions. 

Symbolic links fool the shell. In particular, dirs and 'cd don’t work 
properly once you’ve crossed through a symbolic link. 
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NAME 

csplit — context split 
SYNOPSIS 

csplit [—s] [—k] [—f prefix] file argl [.. . argn] 

DESCRIPTION 

Csplit reads file and separates it into n+1 sections, defined by the argu¬ 
ments argl.. . argn. By default the sections are placed in xxOO ... xxn 
(n may not be greater than 99). These sections get the following pieces 
of file: 

00: From the start of file up to (but not including) the line refer¬ 
enced by orgrj. 

01: From the line referenced by argl up to the line referenced by 
arg2. 

• 

n+1: From the line referenced by argn to the end of file. 

The options to csplit are: 

—s Csplit normally prints the character counts for each file 

created. If the —s option is present, csplit suppresses the 
printing of all character counts. 

—k Csplit normally removes created files if an error occurs. 

If the —k option is present, csplit leaves previously 
created files intact. 

—f prefix If the —f option is used, the created files are named 
prefixQO .. . prefixn. The default is xxOO ... xxn. 

The arguments {argl ... argn) to csplit can be a combination of the fol¬ 
lowing: 

/rexp/ 

A file is to be created for the section from the current line 
up to (but not including) the line containing the regular 
expression reap. The current line becomes the line contain¬ 
ing rexp. This argument may be followed by an optional +or 
— some number of lines (e.g., /Page/—5). 

ZrexpTi 

This argument is the same as /rexp/, except that no file is 
created for the section. 

Inno A file is to be created from the current line up to (but not 
including) fnno. The current line becomes Inno. 

(numj Repeat argument. This argument may follow any of the 
above arguments. If it follows a rexp type argument, that 
argument is applied num more times. If it follows Inno, the 
file will be split every Inno lines (num times) from that 
point. 

Enclose all rexp type arguments that contain blanks or other characters 
meaningful to the Shell in the appropriate quotes. Regular expressions 
may not contain embedded new-lines. Csplit does not affect the original 
file; it is the users responsibility to remove it. 
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EXAMPLES 

csplit —f cobol file '/procedure division/’ /par5./ /parlo./ 

This example creates four files, cobolOO . . . cobolOS. After editing the 
••split" files, they can be recombined as follows: 

cat cobol0[0—3] > file 

Note that this example overwrites the original file, 
csplit—k file 100 (99j 

This example would split the file at every 100 lines, up to 10,000 lines. 
The —k option causes the created files to be retained if there are less 
than 10,000 lines; however, an error message would still be printed. 

csplit—k prog.c '%main(%' + {20{ 

Assuming that prog.c follows the normal C coding convention of ending 
routines with a j at the beginning of the line, this example will create a 
file containing each separate C routine (up to 21) in prog.c. 

SEE ALSO 

ed(l). sh(l). regexp{7). 

DIAGNOSTICS 

Self explanatory except for: 

arg — out of range 

which means that the given argument did not reference a line between 
the current position and the end of the file. 
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NAME 

ctags — create a tags file 
SYNOPSIS 

ctags [ —u ][“-▼][ —w ] [ —X ] name ... 

DESCRIPTION 

Ctags makes a tags file for cx(l) from the specified C, Pascal and Fortran 
sources. A tags file gives the locations of specified objects (in this case 
functions) in a group of files. Each line of the tags file contains the func¬ 
tion name, the file in which it is defined, and a scanning pattern used to 
find the function definition. These are given in separate fields on the 
line, separated by blanks or tabs. Using the tags file, ex can quickly find 
these function definitions. 

If the —X fiag is given, ctags produces a list of function names, the line 
number and file name on which each is defined, as well as the text of that 
line and prints this on the standard output. This is a simple index which 
can be printed out as an off-line readable function index. 

If the —V fiag is given, an index of the form expected by vgrind{l) is pro¬ 
duced on the standard output. This listing contains the function name, 
file name, and page number (assuming 64 line pages). Since the output 
will be sorted into lexicographic order, it may be desired to run the out¬ 
put through sort —f. Sample use: 

ctags —V files 1 sort —f > index 
vgrind —x index 

Files whose name ends in .c or .h are assumed to be C source files and 
are searched for C routine and macro definitions. Others are first exam¬ 
ined to see if they contain any Pascal or Fortran routine definitions; if 
not, they are processed again looking for C definitions. 

Other options are: 

—w suppressing warning diagnostics. 

—u causing the specified files to be updated in tags, that is, all refer¬ 
ences to them are deleted, and the new values are appended to the 
file. (Beware: this option is implemented in a way which is rather 
slow; it is usually faster to simply rebuild the tags file.) 

The tag main is treated specially in C programs. The tag formed is 
created by prepending M to the name of the file, with a trailing .c 
removed, if any, and leading pathname components also removed. This 
makes use of ctags practical in directories with more than one program. 

FILES 

tags output tags file 

SEE ALSO 

ex(l), vi(l) 

AUTHOR 

Ken Arnold; FORTRAN added by Jim Kleckner; Bill Joy added Pascal and 
—X, replacing cxref. 

BUGS 

Recognition of functions, subroutines and procedures for FORTRAN and 
Pascal is done is a very simpleminded way. No attempt is made to deal 
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with block structure; if you have two Pascal procedures in different 
blocks with the same name you lose. 

The method of deciding whether to look for C or Pascal and FORTRAN 
functions is a hack. 
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NAME 

cu - call UNIX 
SYNOPSIS 

cu telno [ -I ] [ -s speed ] [ —a acu ] [ —1 line ] [ —E eotc ] 
DESCRIPTION 

Cu calls up another UNIX system, a terminal, or possibly a non-UNIX sys¬ 
tem. It manages an interactive conversation with possible transfers of 
text files. TbLtio is the telephone number, with minus signs at appropri¬ 
ate places for delays. The —t flag is used to dial out to a terminal. Speed 
gives the transmission speed (110. 134. 150. 300. 1200); 300 is the default 
value. 

The -a and -1 values may be used to specify pathnames for the ACU and 
communications line devices. They can be used to override the following 
built-in choices: 

—a /dev/cuaO —1 /dev/culO 

The -E option changes the EOT character from CTRL-Z to the (decimal) 
value eotc. For file transfer to a different UNIX system often the option 
—E 4 must be given to set EOT to CTRL-D. 

After making the connection, cu runs as two processes: the send process 
reads the standard input and passes most of it to the remote system; the 
receive process reads from the remote system and passes most data to 
the standard output. Lines beginning with have special meanings. 

The send process interprets the following: 

terminate.the conversation, 
terminate the conversation 

send the contents of file to the remote system, as 
though typed at the terminal. 

invoke an interactive shell on the local system. 

run the command on the local system (via sh —c). 

run the command locally and send its output to the 
remote system. 

~%take from [to] 

copy file ’from’ (on the remote system) to file ‘to’ on the 
local system. If ‘to’ is omitted, the ‘from’ name is used 
both places. 

"~%put from [to] copy file ‘from’ (on local system) to file ‘to’ on remote 
system. If ‘to’ is omitted, the ‘from’ name is used both 
places. 

send the line 

The receive process handles output diversions of the following formr 
~>[>][:]file 

zero or more lines to be written to file 
~> 

In any case, output is diverted (or appended, if ’>>’ used) to the file. If ’:’ 
is used, the diversion is silent, i.e.. it is written only to the file. If ’:’ is 


~E0T 

"'<file 

~!cmd ... 
~$cmd ... 
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omitted, output is written both to the file and to the standard output. 
The trailing terminates the diversion. 

The use of ~%put requires stty and cat on the remote side It also 
requires that the current erase and kill characters on 

be^identical to the current ones on the local system. Backslashes are 
inserted at appropriate places. 

The use of ~Xtake requires the existence of echo and tee on the remote 
system. Also, stty tabs mode is required on the remote system if tabs are 
to be copied without expansion. 

EXAMPLE 

cu -t -s 9600 -a /dev/null -1 /dev/tty30 


FILES 

/dev/cuaO 

/dev/culO 

/dev/null 


SEE ALSO 

dn(4). tty(4) 


DIAGNOSTICS 

Exit code is zero 


for normal exit, nonzero (various values) otherwise. 


BUGS 

The syntax is unique. 
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NAME 

cut — cut out selected fields of each line of a file 

SYNOPSIS 

cut —clist [filel files ...] 

cut —flist [—debar] [—s] [filel fileS ...] 

DESCRIPTION 

Use cut to cut out columns from a table or fields from each line of a file; 
in data base parlance, it implements the projection of a relation. The 
fields as specified by list can be fixed length, i.e., character positions as 
on a punched card (—c option), or the length can vary from line to line 
and be marked with a field delimiter character like tab (—f option). Cut 
can be used as a filter; if no files are given, the standard input is used. 

The meanings of the options are: 

list A comma-separated list of integer field numbers (in increasing 
order), with optional — to indicate ranges as in the —o option of 
nroff/troff for page ranges; e.g., 1,4,7; 1—3,8; -5,10 (short for 
1-5,10); or 3— (short for third through last field). 

—clist The list following —c (no space) specifies character positions 
(e.g., —cl—72 would pass the first 72 characters of each line). 

—flist The list following —f is a list of fields assumed to be separated in 
the file by a delimiter character (see —d ); e.g. , —fl,7 copies the 
first and seventh field only. Lines with no field delimiters will be 
passed through intact (useful for table subheadings), unless —s 
is specified. 

—dchar The character following —d is the field delimiter (—f option only). 

Default is tab. Space or other characters with special meaning 
to the shell must be quoted. 

—s Suppresses lines with no delimiter characters in case of —f 

option. Unless specified, lines with no delimiters will be passed 
through untouched. 

Either the —c or —f option must be specified. 

HINTS 

Use grep{l) to make horizontal "cuts” (by context) through a file, or 
pasfe(l) to put files together column-wise (i.e., horizontally). To reorder 
columns in a table, use cut and paste. 

EXAMPLES 

cut —d; —fl,5 /etc/passwd 

mapping of user IDs to names 

name='who am i | cut —fl —d" 

to set name to current login name. 

DIAGNOSTICS 

line too long A line can have no more than 511 characters or fields. 
bad list for c /f option 

Missing —c or —f option or incorrectly specified list. No 
error occurs if a line has fewer fields than the list calls for. 
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no fields The list is empty. 

SEE ALSO 

grep(l). paste(l). 
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NAME 

d — text database functions 
DESCRIPTION 

cd is a set of functions that work on Unix text files with records' like: 

from: Smith to: Jones date: 15.5 re: Unix jobs 
or: 

Title: What is the Title of this Book? 

Author: R.M.Smullyan 

Year: 1978 

Subjects: logic, games, paradox 

or Usenet mail, or a software project database like [Knudsen]. 

d is designed for small text databases like these, where 

• the familiar, fast screen editor can edit the data 

• Unix tools sor^, grep, awk, join ... all work 

• the size and cost of a big database system would be overkill. 

d line, d record, d get, d form: 

d has four subcommands: 

d [Line | record \ get |/ormj [options] [files, or stdin] 

line, record, get, form may be abbreviated I, r, g, f . 

d line 

makes each record into a single 'line', for sorf or awk or ... 
d record 

undoes d line in: 

d line afile 

where cd line 

Unix-filter 
d record 

d get aword 

gets all records contining 'aword', like a fast 
d line \ fgrep aword \ d record 

d form aformfile 

puts fields from the data base into a form, such as: 

Dear (Name|, 

In reply to your {Adjectivej letter of (DateJ, 

or simply selects some fields: 
jPhonej (Namej . 


I Unix-filter \ d record 

flattens each record to one line, 
sorts or aiwA;s ... the lines, and 
makes each line back into a record. 


EXAMPLES 

d get Edinburgh eunet.map 

looks in the eunet map for people in Edinburgh. 
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d line Kproject \ sort -<|'-r+>S | dree 
sorts project records on field 3. 


d record format 

A record is a group of lines, followed by a blank line. A field is 'Field- 
name; Value’, where 'Value' is everything up to the next 'Fieldname': a 
word, a line, or several lines. 'Value' may contain a but not right after 
a letter or number. 

d Line separates fields with a '|’ field separator {awk FS, sort'-t). d 
record then deletes all 'I’s, so that d line j d record does nothing. 

d line also changes newlines in multi-line records to an ersatz newline, 
default ’\’, which d record changes back to \n. To specify your own 
field-separator and newline characters (which must not occur in the 
data): 

dsep= ‘FN’; export dsep . 
dsej3=1\ ' is the default. 

C interface 

d is only a few pages of C code, so it can be easily tailored or extended: 
^include "field.h" 

typedefs a struct field, which holds pointers to fieldname, fieldval 
etc. 

nf = getFields(char*rec, field f[]) 

splits rec into 'fieldname: value’ pairs, filling/[ 0.. nf-l]. 

char* getPara(charnl) 

returns the next paragraph (lines up to \n\n) from the open 
file Parainfile. The text is buffered inside getPara. Paragraphs 
may be no longer than 4096 bytes. \n. s are changed to nl. 

Possible extensions: 

More complicated grefs, such as d get 'Duedate > 15.5’. 

Dates. 

Iget, interactive get. 

References 

Knudsen D.B. et al, "A Modification Request Control System", in Proc. 
2nd International Conference on Software Engineering, San Francisco, 
1976, pp. 187-192. 


Author 

Denis Bzowy, PCS, (089) 67804-275, April 1983. 


February 17, 1984 


Page 2 






D(l) 


MUNIX (pcs) 


D(l) 


SEE ALSO 

awk(l), cut(l), join(l), sort(l), dbm(3X), table(3-pcs) 

BUGS 

Sort, awk etc. may misbehave on records longer than 256 or 512 bytes. 
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NAME 

date — print and set the date 

SYNOPSIS 

date [ mmddhhnim[yy] ] [ +format ] 

DESCRIPTION 

If no argument is given, or if the argument begins with +, the current 
date and time are printed. Otherwise, the current date is set. The first 
mm is the month number; dd is the day number in the month; hh is the 
hour number (24 hour system); the second mm is the minute number; yy 
is the last 2 digits of the year number and is optional. For example: 

date 10080045 

sets the date to Oct 8, 12:45 AM. The current year is the default if no- 
year is mentioned. The system operates in GMT. Date takes care of the 
conversion to and from local standard and daylight time. 

If the argument begins with +, the output of date is under the control of 
the user. The format for the output is similar to that of the first argu¬ 
ment to printf{3S). All output fields are of fixed size (zero padded if 
necessary). Each field descriptor is preceded by % and will be replaced in 
the output by its corresponding value. A single % is encoded by %%. All 
other characters are copied to the output without change. The string is 
always terminated with a new-line character. 

Field Descriptors: 

n insert a new-line character 

t insert a tab character 

m month of year — 01 to 12 
d day of month — 01 to 31 
y last 2 digits of year — 00 to 99 
D date as mm/dd/yy 

H hour — 00 to 23 

M minute — 00 to 59 
S second — 00 to 59 

T time as HH:MM:SS 

j day of year — 001 to 366 
w day of week — Sunday = 0 
a abbreviated weekday — Sun to Sat 

h abbreviated month — Jan to Dec 

r time in AM/PM notation 

EXAMPLE 

date ’+DATE: %m/%d/%y%nTIME: %H:%M:%S' 
would have generated as output: 

DATE: 08/01/76 
TIME:. 14:45:05 

DIAGNOSTICS 

No permission if you aren’t the super-user and you try to change 

the date; 

bad conversion if the date set is syntactically incorrect; 

bad format character if the field descriptor is not recognizable. 

FILES 

/dev/kmem 
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WARNING 

It is a bad practice to change 
multi-user. 


the date while the system i 


running 
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NAME 

dbadd — add entry to an Emacs data base 
dbcreate — create an Emacs data base 
dblist — list contents of an Emacs data base 
dbprint — print an entry from an Emacs data base 

SYNOPSIS 

dbadd dbname key 
dbcreate dbname 

dblist dbname [ “1 ] [ "P newdbname ] 
dbprint dbname key 

DESCRIPTION 

All of these commands deal with databases used by the Unix Emacs data¬ 
base manipulation facilities. A Unix Emacs database is simply a set of 
(key.content) pairs, as in dbm(3X). except that the content part can be a 
very long string. 

Dbadd adds the text from the standard input to the named database 
using the given key. Dbcreate creates the named database, making it 
empty. Dbprint prints the contents of the entry from the database with 
the given key. 

Dblist with no arguments simply lists the keys of all he items in the data¬ 
base. With the -1 option it prints some internal information from the 
database of no interest to anyone but the implementor. The -p option 
causes.the key and content of every entry to be listed as a shell com¬ 
mand file which when executed will repeatedly invoke dbadd to rebuild 
the database. This form of dblist is handy when you want a readable 
ascii file representation of a data base for shipping around or editing. 
Databases should be recreated periodically to garbage collect them. 


FILES 

dbname.dir, dbname.pag, and dbname.dat: the three component subfiles 
of a database. 

SEE ALSO 

James Gosling, 77ie Unix Emacs Manual 

emacs(l), dbm (3X) from which much code was stolen. 


AUTHOR 

James Gosling ® CMU 
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NAME 

dc — desk calculator 

SYNOPSIS 

dc [ file ] 

DESCRIPTION 

Dc is an arbitrary precision arithmetic package. Ordinarily it operates 
on decimal integers, but one may specify an input base, output base, and 
a number of fractional digits to be maintained. The overall structure of 
dc is a stacking (reverse Polish) calculator. If an argument is given, 
input is taken from that file until its end, then from the standard input. 
The following constructions are recognized: 

number 

The value of the number is pushed on the stack. A number is an 
unbroken string of the digits 0-9. It may be preceded by an under¬ 
score _ to input a negative number. Numbers may contain decimal 
points. 

+ - / * % '' 

The top two values on the stack are added (+), subtracted (—), mul¬ 
tiplied (*), divided (/), remaindered (%). or exponentiated (^). The 
two entries are popped off the stack; the result is pushed on the 
stack in their place. Any fractional part of an exponent is ignored. 

sx The top of the stack is popped and stored into a register named x, 
where x may be any character. If the s is capitalized, x is treated 
as a stack and the value is pushed bn it. 

lx The value in register x is pushed on the stack. The register x is not 
altered. All registers start with zero value. If the 1 is capitalized, 
register x is treated as a stack and its top value is popped onto the 
main stack. 

d The top value on the stack is duplicated. 

p The top value on the stack is printed. The top value remains 
unchanged. P interprets the top of the stack as an ascii string, 
removes it, and prints it. 

f All values on the stack and in registers are printed. 

q exits the program. If executing a string, the recursion level is 
popped by two. If q is capitalized, the top value on the stack is 
popped and the string execution level is popped by that value. 

X treats the top element of the stack as a character string and exe¬ 
cutes it as a string of dc commands. 

X replaces the number on the top of the stack with its scale factor. 

[ ... ] puts the bracketed ascii string onto the top of the stack. 

<x >x =x 

The top two elements of the stack are popped and compared. 
Register x is executed if they obey the stated relation. 

V replaces the top element on the stack by its square root. Any exist¬ 
ing fractional part of the argument is taken into account, but oth¬ 
erwise the scale factor is ignored. 
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! interprets the rest of the line as a UNIX command. 

c All values on the stack are popped. 

i The top value on the stack is popped and used as the number radix 
for further input. I pushes the input base on the top of the stack. 

o The top value on the stack is popped and used as the number radix 
for further output. 

0 pushes the output base on the top of the stack. 

k the top of the stack is popped, and that value is used as a non¬ 
negative scale factor; the appropriate number of places are printed 
on output, and maintained during multiplication, division, and 
exponentiation. The interaction of scale factor, input base, and 
output base will be reasonable if all are changed together. 

z The stack level is pushed onto the stack. 

Z replaces the number on the top of the stack with its length. 

? A line of input is taken from the input source (usually the terminal) 
and executed. 

; : are used by be for array operations. 

An example which prints the first ten values of n! is 

[lal+dsa*plalO>y]sy 

Osal 

lyx 


SEE ALSO ^ 

bc(l), which is a preprocessor for dc providing infix notation and a L-like 
syntax which implements functions and reasonable control structures 
for programs. 


DIAGNOSTICS 

'x is unimplemented’ where x is an octal number. 

'stack empty' for not enough elements on the stack to do what was 
asked. 

'Out of space' when the free list is exhausted (too many digits). 

'Out of headers’ for too many numbers being kept around. 

'Out of pushdown’ for too many items on the stack. 

'Nesting Depth’ for too many levels of nested execution. 
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NAME 

dd — convert and copy a file 
SYNOPSIS 

dd [option=value] ... 

DESCRIPTION 

Dd copies the specified input file to the specified output with possible 
conversions. The standard input and output are used by default. The 
input and output block size may be specified to take advantage of raw 
physical I/O. 


option 

iI=fUe 

of =file 

ibs=n 

obs=n 

bs=n 


cbs=n 
skip=n 
8eek=n 
count=n. 
conv=ascii 
' * ebcdic 

ibm 
lease 
ucase 
swab 


values 

input file name; standard input is default 
output file name; standard output is default 
input block size n bytes (default 512) 
output block size (default 512) 

set both input and output block size, superseding tbs and 

o6s; also, if no conversion is specified, it is particularly 

efficient since no in-core copy need be done 

conversion buffer size 

skip n input records before starting copy 

seek n records from beginning of output file before copying 

copy only n input records 

convert EBCDIC to ASCII 

convert ASCII to EBCDIC 

slightly different map of ASCII to EBCDIC 

map alphabetics to lower case 

map alphabetics to upper case 

swap every pair of bytes 


noerror 


do not stop processing on an error 
sync pad every input record to tbs 
....... several comma-separated conversions 


Where sizes are specified, a number of bytes is expected. A number may 
end with k, b, or w to specify multiplication by 1024, 512, or 2 respec¬ 
tively; a pair of numbers may be separated by z to indicate a product. 


Cbs is used only if ascii or ebcdic conversion is specified. In the former 
case cbs characters are placed into the conversion buffer, converted to 
ASCII, and trailing blanks trimmed and new-line added before sending the 
line to the output. In the latter case ASCII characters are read into the 
conversion buffer, converted to EBCDIC, and blanks added to make up an 
output record of size cbs. 

After completion, dd reports the number of whole and partial input and 
output blocks. 

EXAMPLE 

This command will read an EBCDIC tape blocked ten 80-byte EBCDIC card 
images per record into the ASCII file x: 

dd if=/dev/rmtO of=x ibs=800 cbs=80 conv=:ascii,lcase 

Note the use of raw magtape. Dd is especially suited to I/O on the raw 
physical devices because it allows reading and writing in arbitrary record 
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sizes. 

SEE ALSO 

cp(l). 

DIAGNOSTICS 

/+j) records in(out) numbers of full and partial records read(witten) 

BUGS 

The ASCII/EBCDIC conversion tables are taken from the 256 character 
standard in the CACM Nov, 1968. The t6m conversion, while less blessed 
as a standard, corresponds better to certain IBM print train conventions. 
There is no universal solution. 

New-lines are inserted only on conversion to ASCII; padding is done only 
on conversion to EBCDIC. These should be separate options. 
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NAME 

delta — make a delta (change) to an SCCS file 
SYNOPSIS 

delta [—rSID] [—s] [—n] [—glist] [—m[mrlist]] [—y[coniment]] [—p] files 
DESCRIPTION 

Delta is used to permanently introduce into the named SCCS file changes 
that were made to the file retrieved by get{i) (called the g-file, or gen¬ 
erated file). 

Delta makes a delta to each named SCCS file. If a directory is named, 
delta behaves as though each file in the directory were specified as a 
named file, except that non-SCCS files (last component of the path name 
does not begin with s.) and unreadable files are silently ignored. If a 
name of — is given, the standard input is read (see WARNING^; each line 
of the standard input is taken to be the name of an SCCS file to be pro¬ 
cessed. 


Delta may issue prompts on the standard output depending upon certain 
keyletters specified and fiags (see admin{l)) that may be present in the 
SCCS file (see —m and —y keyletters below). 


Keyletter arguments apply independently to each named file. 


-tSID 


—s 


—n 


-glist 


—nj[mrftsf] 


Uniquely identifies which delta is to be made to the 
SCCS file. The use of this keyletter is necessary only if 
two or more outstanding gets for editing (get —e) on 
the same SCCS file were done by the same person 
(login name). The SID value specified with the —r 
keyletter can be either the SID specified on the get 
command line or the SID to be made as reported by the 
get command (see get{l)). A diagnostic results if the 
specified SID is ambiguous, or, if necessary and omit¬ 
ted on the command line. 

Suppresses the-issue, on the standard output, of the 
created delta’s SID, as well as the number of lines 
inserted, deleted and unchanged in the SCCS file. 

Specifies retention of the edited g-file (normally 
removed at completion of delta processing). 

Specifies a list (see yef(l) for the definition of list) of 
deltas which are to be ignored when the file is 
accessed at the change level (SID) created by this 
delta. 

If the SCCS file has the v flag set (see ac£mm(l)) then a 
Modification Request (MR) number must be supplied as 
the reason for creating the new delta. 

If —m is not used and the standard input is a terminal, 
the prompt MRs? is issued on the standard output 
before the standard input is read; if the standard 
input is not a terminal, no prompt is issued. The MRs? 
prompt always precedes the comments? prompt (see 
—y keyletter). 
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MRs in a list are separated by blanks and/or tab char¬ 
acters. An unescaped new-line character terminates 
the UR list. 

Note that if the v flag has a value {see admin{l)), it is 
taken to be the name of a program (or shell pro¬ 
cedure) which will validate the correctness of the MR 
numbers. If a non-zero exit status is returned from MR 
number validation program, delta terminates (it is 
assumed that the UR numbers were not all valid). 


—y[co7nmenf] Arbitrary text used to describe the reason for making 
the delta. A null string is considered a valid comment. 

If —y is not specifled and the standard input is a termi¬ 
nal, the prompt comments? is issued on the standard 
output before the standard input is read; if the stan¬ 
dard input is not a terminal, no prompt is issued. An 
unescaped new-line character terminates the com¬ 
ment text. 

—p Causes delta to print (on the standard output) the 

sees file differences before and after the delta is 
applied in a ciijy(l) format. 

FILES 

All files of the form ?-file are explained in the Source Code Control System 
User's Guide. The naming convention for these files is also described 


there. 


g-file 

Existed before the execution of delta-, removed after 
completion of delta. 

p-file 

Existed before the execution of delta-, may exist after 
completion of delta. 

q-file 

Created during the execution of delta-, removed after 
completion of delta. 

x-file 

Created during the execution of delta-, renamed to SCCS 
file after completion of delta. 

z-file 

Created during the execution of delta; removed during 
the execution of delta. 

d-file 

Created during the execution of delta; removed after 
completion of delta. 


/usr/bin/bdiff Program to compute differences between the “gotten" 
file and the g-file. 


WARNINGS 


Lines beginning with an SOH ASCII character (binary 001) cannot be 
placed in the SCCS file unless the SOH is escaped. This character has spe¬ 
cial meaning to SCCS (see sccsfile{5)) and will cause an error. 

A get of many SCCS files, followed by a delta of those files, should be 
avoided when the get generates a large amount of data. Instead, multiple 
get/delta sequences should be used. 

If the standard input (—) is specified on the delta command line, the —m 
(if necessary) and —y keyletters must also be present. Omission of these 
keyletters causes an error to occur. 
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SEE ALSO 

admin(l), bdiff(l). get(l), help(l), prs(l). sccsfile(5). 

Source Code Control System User's Guide by L. E. Bonanni and C. A. 
Salemi. 

DIAGNOSTICS 

Use help{\) for explanations. 
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NAME 

derofT - remove nroff/troff, tbl, and eqn constructs 
SYNOPSIS 

deroff [ -w ] [ -mx ] [ files ] 

DESCRIPTION 

Deroff reads each of the /lies in sequence and removes all troff{i) 
requests, macro calls, backslash constructs, 6571 ( 1 ) constructs (between 
.EQ and .EN lines, and between delimiters), and fbi(l) descriptions, and 
writes the remainder of the file on the standard output. Deroff follows 
chains of included files (.so and .nx troff commands); if a file has already 
been included, a .so naming that file is ignored and a .nx naming that file 
terminates execution. If no input file is given, deroff reads the standard 
input. 

The -m option may be followed by an m. s, or 1. The resulting -mm or 
—ms option causes the mm or ms macros to be interpreted so that only 
running text is output (i.e., no text from macro lines.) The —ml option 
forces the —mm option and also causes deletion of lists associated with 
the mm macros. 

If the —w option is given, the output is a word list, one "word” per line, 
with all other characters deleted. Otherwise, the output follows the origi¬ 
nal. with the deletions mentioned above. In text, a "word” is any string 
that contains at least two letters and is composed of letters, digits, 
ampersands (&), and apostrophes ('); in a macro call, however, a "word” 
is a string that begins with at least two letters and contains a total of at 
least three letters. Delimiters are any characters other than letters, 
digits, apostrophes, and ampersands. Trailing apostrophes and amper¬ 
sands are removed from "words." 

SEE ALSO 

eqn(l), tbl(l), trofr(l). 

BUGS 

Deroff is not a complete troff interpreter, so it can be confused by subtle 
constructs. Most such errors result in too much rather than too little 
output. 

The —ml option does not handle nested lists correctly. 
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NAME 

df — report number of free disk blocks 
SYNOPSIS 

] [ —f ] [ file-systems ] 

DESCRIPTION 

Df prints out the number of free blocks and free i-nodes available for'^ 
on-line file systems by examining the counts kept in the super-blocks; 
file-systems may be specified either by device, name (e.g., /dev/rpl) or 
by mounted directory name (e.g., /usr). If the file-systems argument is 
unspecified, the free space on all of the mounted file systems is printed. 

The —t flag causes the total allocated block figures to be reported as well. 

If the —f flag is given, only an actual count of the blocks in the free list is 
made (free i-nodes are not reported). With this option, df will report on 
raw devices. 

FILES 

/dev/rf* 

/dev/rk* 

/dev/rp* 

/etc/mnttab 

SEE ALSO 

fsck(8), fs(5), mnttab(5). 
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NAME 

diction, explain — print wordy sentences, interactive thesaurus for dic¬ 
tion 

SYNOPSIS 

diction [ -ml ] [ -mm ] [ -n ] [ -f pfile ] file ... 
explain 

DESCRIPTION 

IXctxon finds all sentences in a document that contain phrases from a 
data base of bad or wordy diction. Each phrase is bracketed with [ 1. 
Because dzcfion runs deroff before looking at the text, formatting header 
files should be included as part of the input. The default macro package 
-ms may be overridden with the flag -mm. The flag -ml which causes 
deron to skip lists, should be used if the document contains many lists of 
non-sentences. The user may supply her/his own pattern file to be used 
in addition to the default file with ~t pfile. If the flag -n is also supplied 
the default file will be supressed. 

Explain is an interactive thesaurus for the phrases found by diction. 

SEE ALSO 

derofT(l) 

BUGS 

Use of non-standard formatting macros may cause incorrect sentence 
breaks. 
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NAME 

diff — differential file comparator 
SYNOPSIS 

diff [ — efbh ] filel file2 
DESCRIPTION 

Diff tells what lines must be changed in two files to bring them into 
agreement. It filel (fileS) is the standard input is used. It filel {file2) 
is a directory, then a file in that directory whose file^name is the same as 
the file-name ot file2 [filel') is used. The normal output contains lines of 
these forms: 

ni a n3,n4 
nl,n2 d n3 
Til,n2 c n3.n4 

These lines resemble ed commands to convert filel into file2. The 
numbers after the letters pertain to file2. In fact, by exchanging 'a' for 
'd' and reading backward one may ascertain equally how to convert file2 
into filel. As in ed, identical pairs where nl = n2 or n3 = n4 are abbrevi¬ 
ated as a single number. 

Following each of these lines come all the lines that are affected in the 
first file fiagged by < , then all the lines that are affected in the second 
file fiagged by ■>*. « 

The b option causes trailing blanks (spaces and tabs) to be ignored and 
other strings of blanks to compare equal. 

The —e option produces a script of a, c and d commands for the editor ed, 
which will recreate file2 from filel. The — f option produces a similar 
script, not useful with ed, in the opposite order. In connection with —e, 
the following shell program may help maintain multiple versions of a file. 
Only an ancestral file (Si) and a chain of version-to-version ed scripts 
($2,$3,...) made by diff need be on hand. A ‘latest version’ appears on the 
standard output. 

(shift; cat S*; echo'l,Sp') I ed - SI 

Except in rare circumstances, diff finds a smallest sufficient set of file 
differences. 

Option —h does a fast, half-hearted job. It works only when changed 
stretches are short and well separated, but does work on files of unlim¬ 
ited length. Options —e and —f are unavailable with —h. 

FILES 

/tmp/d????? 

/usr/lib/diffh for —h 
SEE ALSO 

cmp(l). comm(l), ed(l) 

DIAGNOSTICS 

Exit status is 0 for no differences, 1 for some, 2 for trouble. 

BUGS 

Editing scripts produced under the —e or — f option are naive about 
creating lines consisting of a single 
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NAME 

difT3 — 3*way differential file comparison 
SYNOPSIS 

dilT3 [ —ex3 ] filel file2 file3 
DESCRIPTION 

Diff3 compares three versions of a file, and publishes disagreeing ranges 
of text flagged with these codes: 

==== all three files differ 

====1 filel is different 

====2 files is different 

====3 filed is different 

The type of change suffered in converting a given range of a given file to 
some other is indicated in one of these ways; 

/ ; nj a Text is to be appended after line number nl in file /, 

where f - 1, 2, or 3. 

/ : ni ,n2 c Text is to be changed in the range line nl to line n2. If nl 
= n2, the range may be abbreviated to nl. 

The original contents of the range follows immediately after a c indica¬ 
tion. When the contents of two files are identical, the contents of the 
lower-numbered file is suppressed. 

Under the —e option, diffS publishes a script for the editor ed that will 
incorporate into filel all changes between fileS and filed, i.e. the 
changes that normally would be flagged ==== and ====3. Option —x 
(~3) produces a script to incorporate only changes flagged ==== 
(==== 3 ). The following command will apply the resulting script to 'filer. 

(cat script; echo 'l,Sp') | ed - filel 

FILES 

/tmp/d3????? 

/usr/lib/diff3 

SEE ALSO 

diff(l) 

BUGS 

Text lines that consist of a single will defeat —e. 

Files longer than 64K bytes won't work. 
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NAME 

dircmp — directory comparison 

SYNOPSIS 

dircmp dirl dir2 

DESCRIPTION 

Dircmp examines dirl and dir2 and generates various tabulated infor¬ 
mation about the contents of the directories. Listings of files that are 
unique to each directory are generated in addition to a list that indi¬ 
cates whether the files common to both directories have the same con¬ 
tents. 

SEE ALSO 

cmp(l). difT(l). 
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NAME 

du — summarize disk usage 
SYNOPSIS 

du [ —ars ] [ names ] 

DESCRIPTION 

Da gives the number of blocks contained in all files and (recursively) 
directories within each directory and file specified by the names argu¬ 
ment. The block count includes the indirect blocks of the file. If names 
is missing, . is used. 

The optional argument —s causes only the grand total (for each of the 
specified names) to be given. The optional argument —a causes an entry 
to be generated for each file. Absence of either causes an entry to be 
generated for each directory only. 

Da is normally silent about directories that cannot be read, files that 
cannot be opened, etc. The —r option will cause du to generate messages 
in such instances. 

A file with two or more links is only counted once. 

BUGS 

If the —a option is not used, non-directories given as arguments are not 
listed. 

If there are too many distinct linked files, du will count the excess files 
more than once. 

Files with holes in them will get an incorrect block count. 
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NAME 

echo — echo arguments 

SYNOPSIS 

echo [ arg ] ... 

DESCRIPTION 

Echo writes its arguments separated by blanks and terminated by a new- 
line on the standard output. It also understands C-like escape conven¬ 
tions; beware of conflicts with the shell’s use of \: 


\b 
\c 
\f 
\ n 
\r 
\t 
\\ 
\n 


backspace 

print line without new-line 

form-feed 

new-line 

carriage return 

tab 

backslash 

the 8-bit character whose ASCII code is the 1-, 2- or 3-digit 
octal number n, which must start with a zero. 


Echo is useful for producing diagnostics in command files and for sending 
known data into a pipe. 


SEE ALSO 

sh(l). 
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NAME 

ed, red — text editor 
SYNOPSIS 

ed [ - ] [ -X ] [ file ] 
red [ - ] [ -X ] [ file ] 

DESCRIPTION 

Ed is the standard text editor. If the file argument is given, ed simulates 
an e command (see below) on the named file; that is to say, the file is 
read into ed’s buffer so that it can be edited. The optional — suppresses 
the printing of character counts by e, r. and w commands, of diagnostics 
from e and q commands, and of the ! prompt after a \shell command. If 
—X is present, an i command is simulated first to handle an encrypted 
file. Ed operates on a copy of the file it is editing: changes made to the 
copy have no effect on the file until a w (write) command is given. The 
copy of the text being edited resides in a temporary file called the buffer. 
There is only one buffer. 

Red is a restricted version of ed. It will only allow editing of files in the 
current directory. It prohibits executing shell commands via 
\shell command. Attempts to bypass these restrictions result in an error 
message {restricted shell). 

Both ed and red support the/spec (5) formatting capability. After includ¬ 
ing a format specification as the first line of file and invoking ed with 
your terminal in stty —tabs or stty tab3 mode (see s«y(l). the specified 
tab stops will automatically be used when scanning ^fe. For example, if 
the first line of a file contained: 

<:t5.10.15 s72:> 

tab stops would be set at columns 5, 10 and 15, and a maximum line 
length of 72 would be imposed. NOTE: while inputting text, tab characters 
when typed are expanded to every eighth column as is the default. 

Commands to ed have a simple and regular structure: zero, one, or two 
addresses followed by a single-character command, possibly followed by 
parameters to that command. These addresses specify one or more lines 
in the buffer. Every command that requires addresses has default 
addresses, so that the addresses can very often be omitted. 

In general, only one command may appear on a line. Certain commands 
allow the input of text. This text is placed in the appropriate place in the 
buffer. While ed is accepting text, it is said to be in input mode. In this 
mode, no commands are recognized; all input is merely collected. Input 
mode is left by typing a period (.) alone at the beginning of a line. 

Ed supports a limited form of regular expression notation; regular 
expressions are used in addresses to specify lines and in some commands 
(e.g., s) to specify portions of a line that are to be substituted. A regular 
expression (RE) specifies a set of character strings. A member of this set 
of strings is said to be matched by the RE. The REs allowed by ed are 
constructed as follows: 

The following one-character REs match a single character: 

1.1 An ordinary character (nof one of those discussed in 1.2 below) is a 
one-character RE that matches itself. 


Page 1 


February 17, 1984 






ED(1) 


MUNIX 


ED(l) 


1.2 A backslash (\) followed by any special character is a one- 
character RE that matches the special character itself. The special 
characters are: 

a. .. ♦, [, and \ (period, asterisk, left square bracket, and 
backslash, respectively), which are always special, except when 
they appear within square brackets ([]; see 1.4 below). 

b. ./V (caret or circumflex), which is special at the beginning of an 
entire RE (see 3.1 and 3.2 below), or when it immediately follows 
the left of a pair of square brackets ([]) (see 1.4 below). 

c. % (currency symbol), which is special at the end of an entire RE 
(see 3.2 below). 

d. The character used to bound (i.e., delimit) an entire RE. which 
is special for that RE (for example, see how slash (/) is used in 
the g command, below.) 

1.3 A period (.) is a one-character RE that matches any character 
except new-line. 

1.4 A non-empty string of characters enclosed in square brackets ([]) 
is a one-character RE that matches any one character in that, 
string. If, however, the first character of the string is a circumflex 
(.-v), the one-character RE matches any character except new-line 
and the remaining characters in the string. The has this special 
meaning only if it occurs first in the string. The minus (—) may be 
used to indicate a range of consecutive ASCII characters; for exam¬ 
ple, [0—9] is equivalent to [0123456789]. The — loses this special 
meaning if it occurs first (after an initial if any) or last in the 
string. The right square bracket (]) does not terminate such a 
string when it is the first character within it (after an initial if 
any): e.g., []a—f] matches either a right square bracket (]) or one 
of the letters a through f inclusive. The four characters listed in 
1.2.a above stand for themselves within such a string of characters. 

The following rules may be used to construct REs from one-character 

REs: 

2.1 A one-character RE is a RE that matches whatever the one- 
character RE matches. 

2.2 A one-character RE followed by an asterisk (•) is a RE that matches 
zero or more occurrences of the one-character RE. If there is any 
choice, the longest leftmost string that permits a match is chosen. 

2.3 A one-character RE followed by \[m\j, \(m,\J, or \{m.,n\ j is a 
RE that matches a range of occurrences of the one-character RE. 
The values of m and n must be non-negative integers less than 256; 
\{m\j matches exactly m occurrences; \[m,\j matches at least 
m occurrences; \{m,n\j matches any number of occurrences 
between m and n inclusive. Whenever a choice exists, the RE 
matches as many occurrences as possible. 

2.4 The concatenation of REs is a RE that matches the concatenation of 
the strings matched by each component of the RE. 
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2.5 A RE enclosed between the character sequences \( and \) is a RE 
that matches whatever the unadorned RE matches. 

2.6 The expression \n matches the same string of characters as was 
matched by an exprepion enclosed between \ ( and \ ) earlier in 
the same RE. Here n is a digit; the sub-expression specified is that 
beginning with the n-th occurrence of \ ( counting from the left. 
For example, the expression ■^\(.*\)\ IS matches a line consisting 
of two repeated appearances of the same string. 

Finally, an entire RE may be constrained to match only an initial segment 
or final segment of a line (or both); 


3.1 


3.2 


A circumflex (^) at the beginning of an entire RE constrains that RE 
to match an initial segment of a line. 

A currency symbol (S) at the end of an entire RE constrains that RE 
to match a. final segment of a line. 

The construction ^entire RES constrains the entire RE to match the 
entire line. 


The null RE (e.g., //) is equivalent to the last RE encountered. See also 
the last paragraph before FILES below. 

To understand addressing in ed it is necessary to know that at any time 
there is a current line. Generally speaking, the current line is the last 
line affected by a command; the exact effect on the current line is dis¬ 
cussed under the description of each command. Addresses are con¬ 
structed as follows: 

1. The character . addresses the current line. 

2. The character S addresses the last line of the buffer. 

3. A decimal number n addresses the n-th line of the buffer. 

4. 'z addresses the line marked with the mark name character z, 
which must be a lower-case letter. Lines are marked with the k 
command described below. 



5. 


6 . 


A RE enclosed by slashes (/) addresses the first line found by 
searching fonward from the line following the current line toward 
the end of the buffer and stopping at the first line containing a 
string matching the RE. If necessary, the search wraps around to 
the beginning of the buffer and continues up to and including the 
current line, so that the entire buffer is searched. See also the last 
paragraph before FILES below. 

A RE enclosed in question marks (?) addresses the first line found 
by searching backward from the line preceding the current line 
toward the beginning of the buffer and stopping at the first line 
containing a string matching the RE. If necessary, the search wraps 
around to the end of the buffer and continues up to and including 
the current line. See also the last paragraph before FILES below. 

An address followed by a plus sign ( + ) or a minus sign (—) followed 
by a decimal numbep specifies that address plus (respectively 
minus) the indicated number of lines. The plus sign may be omit¬ 
ted. 


o 
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8. If an address begins with + or —. the addition or subtraction is 
taken with respect to the current line; e.g, —5 is understood to 
mean .—5. 

9. If an address ends with + or —, then 1 is added to or subtracted 
from the address, respectively. As a consequence of this rule and of 
rule 8 immediately above, the address — refers to the line preceding 
the current line. (To maintain compatibility with earlier versions of 
the editor, the character ^ in addresses is entirely equivalent to 
—.) Moreover, trailing + and — characters have a cumulative effect, 
so — refers to the current line less 2. 

10. For convenience, a comma (.) stands for the address pair l.S, while 
a semicolon (;) stands for the pair 

Commands may require zero, one, or two addresses. Commands that 
require no addresses regard the presence of an address as an error. 
Commands that accept one or two addresses assume default addresses 
when an insufficient number of addresses is given; if more addresses are 
given than such a command requires, the last one(s) are used. 

Typically, addresses are separated from each other by a comma (,). They 
may also be separated by a semicolon (;). In the latter case, the current 
line (.) is set to the first address, and only then is the second address 
calculated. This feature can be used to determine the starting line for 
forward and backward searches (see rules 5. and 6. above). The second 
address of any two-address sequence must correspond to a line that fol¬ 
lows. in the buffer, the line corresponding to the first address. 

In the following list of ed commands, the default addresses are shown in 
parentheses. The parentheses are not part of the address; they show 
that the given addresses are the default. 

It is generally illegal for more than one command to appear on a line. 
However, any command (except e, /, r. or w) may be suffixed by 1. n or p, 
in which case the current line is either listed, numbered or printed, 
respectively, as discussed below under the I, n andp commands. 

(.)a 

<text> 


The append command reads the given text and appends it after 
the addressed line; . is left at the last inserted line. or. if there 
were none, at the addressed line. Address 0 is legal for this com¬ 
mand: it causes the "appended” text to be placed at the beginning 
of the buffer. The maximum number of characters that may be 
entered from a terminal is 256 per line (including the newline 
character). 

(•)c 

<text> 


The change command deletes the addressed lines, then accepts 
input text that replaces these lines; . is left at the last line input, 
or. if there were none, at the first line that was not deleted. 

(..-)d 

The delete command deletes the addressed lines from the buffer. 
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The line after the last line deleted becomes the current line; if the 
lines deleted were originally at the end of the buffer, the new last 
line becomes the current line. 

e file 

The edit command causes the entire contents of the buffer to be 
deleted, and then the named file to be read in; . is set to the last 
line of the buffer. If no file name is given, the currently- 
remembered file name, if any, is used (see the / command). The 
number of characters read is typed; file is remembered for possi¬ 
ble use as a default file name in subsequent e, r, and w commands. 
If file is replaced by !, the rest of the line is taken to be a shell 
(s/i(l)) command whose output is to be read. Such a shell com¬ 
mand is not remembered as the current file name. See also DIAG¬ 
NOSTICS below. 

E/iie 

The £'dit command is like e, except that the editor does not check 
to see if any changes have been made to the buffer since the last 
w command. 

I file- 

If file is given, the /ile-name command changes the currently- 
remembered file name to file-, otherwise, it prints the currently- 
remembered file name. 

( 1 ,%)g/RE/command list 

In the grlobal command, the first step is to mark every line that 
matches the given RE. Then, for every such line, the given com¬ 
mand list is executed with . initially set to that line. A single com¬ 
mand or the first of a list of commands appears on the same line 
as the global command. All lines of a multi-line list except the last 
line must be ended with a \ ; a, i, and c commands and associated 
input are permitted; the . terminating input mode may be omitted 
if it would be the last line of the command list. An empty com¬ 
mand list is equivalent to the p command. The g, G.v, and V com¬ 
mands are not permitted in the command list. See also BUGS and 
the last paragraph before FILES below. 

( l.S)G/;?£'/ 

In the interactive Clobal command, the first step is to mark every 
line that matches the given RE. Then, for every such line, that line 
is printed, . is changed to that line, and any one command (other 
than one of the a, c, i, g, G, v, and V commands) may be input and 
is executed. After the execution of that command, the next 
marked line is printed, and so on; a new-line acts as a null com¬ 
mand; an Sc causes the re-execution of the most recent command 
executed within the current invocation of G. Note that the com¬ 
mands input as part of the execution of the G command may 
address and affect any lines in the buffer. The G command can be 
terminated by an interrupt signal (ASCII DEL or BREAK). 

h 

The Aelp command gives a short error message that explains the 
reason for the most recent ? diagnostic. 
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H 

The //elp command causes ed to enter a mode in which error mes¬ 
sages are printed for all subsequent ? diagnostics. It will also 
explain the previous ? if there was one. The H command alter¬ 
nately turns this mode on and off; it is initially off. 

(•)i 

<text> 

The insert command inserts the given text before the addressed 
line; . is left at the last inserted line, or, if there were none, at the 
addressed line. This command differs from the a command only in 
the placement of the input text. Address 0 is not legal for this 
command. The maximum number of characters that may be 
entered from a terminal is 256 per line (including the newline 
character). 

The join command joins contiguous lines by removing the 
appropriate new-line characters. If exactly one address is given, 
this command does nothing. 

(.)kx 

The marA: command marks the addressed line with name x, which 
must be a lower-case letter. The address 'x then addresses this 
line; . is unchanged. 

The iist command prints the addressed lines in an unambiguous 
way: a few non-printing characters (e.g., fab, backspace) are 
represented by (hopefully) mnemonic overstrikes, all other non¬ 
printing characters are printed in octal, and long lines are folded. 
An I command may be appended to any other command other 
than e, f.r, or w. 

(... )ma 

The move command repositions the addressed line(s) after the 
line addressed by a. Address 0 is legal for a and causes the 
addressed line(s) to be moved to the beginning of the file; it is an 
error if address a falls within the range of moved lines; . is left at 
the last line moved. 

(...)n 

The number command prints the addressed lines, preceding each 
line by its line number and a tab character; . is left at the last line 
printed. The n command may be appended to any other command 
other than e, /, r, or w. 

(•.•)P 

The jarint command prints the addressed lines; . is left at the last 
line printed. The p command may be appended to any other com¬ 
mand other than e.f.r, or w, for example, dp deletes the current 
line and prints the new current line. 

P 

The editor will prompt with a • for all subsequent commands. The 
P command alternately turns this mode on and off; it is initially 
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off. 

q 

The command causes ec£ to exit. No automatic write of a file 
is done (but see DIAGNOSTICS below). 

Q 

The editor exits without checking if changes have been made in 
the buffer since the last w command. 

The read command reads in the given file after the addressed line. 
If no file name is given, the currently-remembered file name, if 
any. is used (see e and / commands). The currently-remembered 
file name is nof changed unless file is the very first file name men¬ 
tioned since ed was invoked. Address 0 is legal for r and causes 
the file to be read at the beginning of the buffer. If the read is 
successful, the number of characters read is typed; . is set to the 
last line read in. If file is replaced by !, the rest of the line is 
taken to be a shell (s/j,(l)) command whose output is to be read. 
For example, "$r !ls'' appends current directory to the end of the 
file being edited. Such a shell command is nof remembered as the 
current file name. 

)s/RE/replacement / or 

(.,. )s/RE /replacement /g 

The substitute command searches each addressed line for an 
occurrence of the specified RE. In each line in which a match is 
found, all (non-overlapped) matched strings are replaced by the 
replacement if the global replacement indicator g appears after 
the command. If the global indicator does not appear, only the 
first occurrence of the matched string is replaced. It is an error 
for the substitution to fail on all addressed lines. Any character 
other than space or new-line may be used instead of / to delimit 
the RE and the replacement; . is left at the last line on which a 
substitution occurred. See also the last paragraph before FILES 
below. 

An ampersand (&) appearing in the replacement is replaced by the 
string matching the RE on the current line. The special meaning 
of tc in this context may be suppressed by preceding it by \. As a 
more general feature, the characters \n, where n is a digit, are 
replaced by the text matched by the n-th regular subexpression 
of the specified RE enclosed between \( and \). When nested 
parenthesized subexpressions are present, n is determined by 
counting occurrences of \( starting from the left. When the char¬ 
acter % is the only character in the replacement, the replacement 
used in the most recent substitute command is used as the 
replacement in the current substitute command. The % loses its 
special meaning when it is in a replacement string of more than 
one character or is preceded by a \ . 

A line may be split by substituting a new-line character into it. 
The new-line in the replacement must be escaped by preceding it 
by \ • Such substitution cannot be done as part of a ^ or u 
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command list. 

(...)ta 

This command acts just like the m command, except that a copy 
of the addressed lines is placed after address a (which may be 0); . 
is left at the last line of the copy. 

u 

The undo command nullifies the effect of the most recent com¬ 
mand that modified anything in the buffer, namely the most 
recent a, c, d, g, i, j, m, r, s, t, v, G, or V command. 

( 1 /RE/command List 

This command is the same as the global command g except that 
the command List is executed with . initially set to every line that 
does not match the RE. 

RE/ 

This command is the same as the interactive global command G 
except that the lines that are marked during the first step are 
those that do nof match the RE. 

The twrite command writes the addressed lines into the named file. 
If the file does not exist, it is created with mode 666 (readable and 
writable by everyone), unless your umask setting (see s/i(l)) dic¬ 
tates otherwise. The currently-remembered file name is not 
changed unless fiLe is the very first file name mentioned since ed 
was invoked. If no file name is given, the currently-remembered 
file name, if any, is used (see e and / commands); . is unchanged. 
If the command is successful, the number of characters written is 
typed. If fiLe is replaced by !, the rest of the line is taken to be a 
shell (s/i(l)) command whose standard input is the addressed 
lines. Such a shell command is not remembered as the current file 
name. 

X 

A key string is demanded from the standard input. Subsequent e, 
r, and w commands will encrypt and decrypt the text with this key 
by the algorithm of crypt{l). An explicitly empty key turns off 
encryption. 

(S)= 

The line number of the addressed line is typed; . is unchanged by 
this command. 

IsheLL command 

The remainder of the line after the ! is sent to the UNIX System 
shell (s/i(l)) to be interpreted as a command. Within the text of 
that command, the unescaped character /C is replaced with the 
remembered file name; if a ! appears as the first character of the 
shell command, it is replaced with the text of the previous shell 
command. Thus, !! will repeat the last shell command. If any 
expansion is. performed, the expanded line is echoed; . is 
unchanged. 
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(.+1 )<new-line> 

An address alone on a line causes the addressed line to be printed 
A new-line alone is equivalent to .+lp; it is useful for stepping for¬ 
ward through the buffer. 

If an interrupt signal (ASCII DEL or BREAK) is sent, ed prints a ? and 
returns to its command level. 

Some size limitations: 512 characters per line, 256 characters per global 
command list, 64 characters per file name, and 128K characters in the 
buffer. The limit on the number of lines depends on the amount of user 
memory; each line takes 1 word. 

When reading a file, ed discards ASCII NUL characters and all characters 
after the last new-line. Files (e.g., a.out) that contain characters not in 
the ASCII set (bit 8 on) cannot be edited by ed. 

If the closing delimiter of a RE or of a replacement string (e.g., /) would 
be the last character before a new-line, that delimiter may be omitted, in 
which case the addressed line is printed. The following pairs of com¬ 
mands are equivalent; 

s/sl/s2 s/sl/s2/p 
g/sl g/sl/p 

?sl ?sl? 

FILES 

/tmp/e# 

temporary; # is the process number, 
ed.hup work is saved here if the terminal is hung up. 

DIAGNOSTICS 

? for command errors. 

?fiLe for an inaccessible file. 

(use the help and Help commands for detailed explanations). 

If changes have been made in the buffer since the last w command that 
wrote the entire buffer, ed warns the user if an attempt is made to des¬ 
troy ed’s buffer via the e or g commands; it prints ? and allows one to 
continue editing. A second e or g command at this point will take effect. 
The — command-line option inhibits this feature. 

SEE ALSO 

crypt(l), grep(l). sed(l), sh(l). stty(l), fspec(5), regexp(7). 

A TutoriaL Introduction to the UNIX Text Editor by B. W. Kernighan. 
Advanced Editing on UNIX hy B. W. Kernighan. 

CAVEATS AND BUGS 

A ! command cannot be subject to a g or a v command. 

The ! command and the ! escape from the e, r, and w commands cannot 
be used if the the editor is invoked from a restricted shell (see sh(l)). 

The sequence \n in a RE does not match a new-line character. 

The I command mishandles DEL. 

Files encrypted directly with the crypt{!) command with the null key 
cannot be edited. 

Characters are masked to 7 bits on input. 
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NAME 

efl ~ Extended Fortran Language 
SYNOPSIS 

efl [ options ] [ files ] 

DESCRIPTION 

Efl compiles a program written in the EFL language into clean Fortran on 
the standard output. Efl provides the C-like control constructs of rat- 
/or(l): 

statement grouping with braces, 
decision-making: 

if, if-else, and select-case (also known as switch-case); 
while, for, Fortran do, repeat, and repeat... until loops; 
multi-level break and next. 

EFL has C-like data structures, e.g.; 
struct 

{ 

integer fiags(3) 
character(8) name 
long real coords(2) 
j table(lOO) 

The language offers generic functions, assignment operators (+=, &=, 
etc.), and sequentially evaluated logical operators (&& and |). There is a 
uniform input/output syntax; 

write(6.x,y:f(7,2), do i=l,10 { a(i,j),z.b(i) j) 

EFL also provides some syntactic "sugar”: 
free-form input; 

multiple statements per line; automatic continuation; state¬ 
ment label names (not just numbers). 

comments; 

# this is a comment. 

translation of relational and logical operators: 

>. >=. &. etc., become ,GT., .GE., .AND., etc. 

return expression to caller from function: 
return {expression) 

defines: 

define name replacement 

includes; 

include file 

Eifl understands several option arguments; — w suppresses warning mes¬ 
sages, ^ suppresses comments in the generated program, and the 
default option —C causes comments to be included in the generated pro¬ 
gram. 

An argument with an embedded = (equal sign) sets an EFL option as if it 
had appeared in an option statement at the start of the program. Many 
options are described in the reference manual. A set of defaults for a 
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particular target machine may be selected by one of the choices: 
system=unix, system=gcos, or syslem=cray. The default setting of the 
system option is the same as the machine the compiler is running on. 
Other specific options determine the style of input/output, error han¬ 
dling, continuation conventions, the number of characters packed per 
word, and default formats. 

Efl is best used with/77(l). 

SEE ALSO 

cc(l). f77(l). ratfor(l). 

The Programming Language EFL by S.I. Feldman. 
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NAME 

emacs — a screen editor 
SYNOPSIS 

emacs files... 

DESCRIPTION 

Unix Emacs is a text editor styled after the editors of the same name 
that exist on ITS, Twenex and Multics. Invoking emacs with a list of files 
causes emacs to start up and do a visit-file on each of the named files. 
For more information, read the manual. 

FILES 

/usr/lib/emacs/* 

ENVIRONMENT 

EPATH is a path used when locating files with the load command. 

SEE ALSO 

The Unix Emacs manual, which should be on /usr/doc/emacs 

BUGS 

Probably many on the CADMUS. Emacs needs virtual memory, as it grows 
very big. 

HISTORY 

08-Jan-81 James Gosling (jag) at Carnegie-Mellon University 
Created. 
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NAME 

env — set environment for command execution 
SYNOPSIS 

env [—] [ name=value ] ... [ command args ] 

DESCRIPTION 

obtains the current environment, modifies it according to its argu¬ 
ments, then executes the command with the modified environment. 
Arguments of the form name=value are merged into the inherited 
environment before the command is executed. The - flag causes the 
inherited environment to be ignored completely, so that the command is 
executed with exactly the environment specified by the arguments. 

If no command is specified, the resulting environment is printed, one 
name-value pair per line. 

SEE ALSO 

sh(l), exec(2), proflle(5), environ(7). 
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NAME 

eqn, neqn, checkeq - format mathematical text for nroff or troff 
SYNOPSIS 

eqn [ -dxy ] [ -pn ] [ -sn ] [ -fn ] [ files ] 
neqn [ -dxy ] [ -pn ] [ -sn ] [ -fn ] [ files ] 
checkeq [ files ] 

DESCRIPTION 

Eqn is & troffil) preprocessor for typesetting mathematical text on a 
>^ng Laboratories. Inc. C/A/T phototypesetter, while neqn is used for 
the same purpose with nroff{i) on typewriter-like terminals. Usage is 
almost always: 

eqn files | troff 
neqn files | nroff 

or equivalent. 

If no files are specified, these programs read from the standard input A 
line beginning with .EQ marks the start of an equation; the end of an 
equation is marked by a line beginning with .EN. Neither of these lines is 
altered, so they may be defined in macro packages to get centering, 
numbering, etc. It is also possible to designate two characters as delim¬ 
iters-, subsequent text between delimiters is then treated as eqn input. 
Delimiters may be set to characters x and y with the command-line argu¬ 
ment —dzy or (more commonly) with delim xy between .EQ and .EN. The 
left and right delimiters may be the same character; the dollar sign is 
often used as such a delimiter. Delimiters are turned off by delim off. All 
text that is neither between delimiters nor between .EQ and .EN is passed 
through untouched. 

The program checkeq reports missing or unbalanced delimiters and 
.EQ/.EN pairs. 

Tokens within eqn are separated by spaces, tabs, new-lines, braces, dou¬ 
ble quotes, tildes, and circumflexes. Braces (j are used for grouping; 
generally speaking, anywhere a single character such as * could appear, 
a complicated construction enclosed in braces may be used instead. 
Tilde (r^-) represents a full space in the output, circumflex (^) half as 
much. 

Subscripts and superscripts are produced with the keywords sub and 
sup. Thus X sub j makes xj, a sub k sup 2 produces a**, while b»**«'* is 
made with e sup \x sup 2 + y sup 21. Fractions are made with over: 

a over b yields sqrt makes square roots: 1 over sqrt \ax sup 2-^bx+cl 

results in —— , 
vaz*+6x+c 


The keywords from and to introduce lower and upper limits: is 

n Q 

made with limfrom {n —> inf J sum from 0 to n x sub i. Left and right 
brackets, braces, etc., of the right height are made with left and right: 


= 1 . 


left [ X sup 2 ■>r y sup 2 over alpha right ] i produces 

Legal characters after left and right are braces, brackets, bars, c and f 


a 
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for ceiling and floor, and "" for nothing at all (useful for a right-side-only 
bracket). A left thing need not have a matching right thing. 

Vertical piles of things are made with pile, Ipile, cpile, and rpile: 

a 

pile (a above b above c{ produces 6. Piles may have arbitrary numbers 

c 

of elements; Ipile left-justifles, pile and cpile center (but with different 
vertical spacing), and rpile right justifies. Matrices are made with matrix; 

matrix j IcoL j x sub i above y sub 2 j cool { i above 2 j J produces g- 
In addition, there is rcol for a right-justifled column. 

Diacritical marks are made with dot, dotdot, hat, tilde, bar, vec, dyad, 
and under: x dot = f(t) bar is x=f{t), y dotdot bar = n under is y = n, 
and X vec y dyad is i = g. 

Point sizes and fonts can be changed with size n or size ±n. roman, italic, 
bold, and font n. Point sizes and fonts can be changed globally in a 
document by gsize n and gfont n, or by the command-line arguments 
—sn and —fn. 

Normally, subscripts and superscripts are reduced by 3 points from the 
previous size; this may be changed by the command-line argument —pn. 

Successive display arguments can be lined up. Place meirk before the 
desired lineup point in the first equation; place lineup at the place that is 
to line up vertically in subsequent equations. 

Shorthands may be defined or existing keywords redefined with define: 
define thing % replacement % 

defines a new token called thing that will be replaced by replacement 
whenever it appears thereafter. The /i may be any character that does 
not occur in replacement. 

Keywords such as sum (2). int (/). inf (»). and shorthands such as >= (fe). 
!= (/). and —> (-•) are recognized. Greek letters are spelled out in the 
desired case, as in edpha (o), or GAMMA (F). Mathematical words such as 
sin, cos, and log are made Roman automatically. Troff{l) four-character 
escapes such as \ (dd ($) and \ (bs (©may be used anywhere. Strings 
enclosed in double quotes ("...") are passed through untouched; this 
permits keywords to be entered as text, and can be used to communicate 
with troff{].) when all else fails. Full details are given in the manual cited 
below. 

SEE ALSO 

Typesetting Mathematics—User’s Guide by B. W. Kernighan and L. L. 
Cherry. 

New Graphic Symbols for EQN and NEQN by C. Scrocca. 
mm(l). mmt(l). tbl(l), troff (l), eqnchar(7). mm(7), mv(7). 

BUGS 

To embolden digits, parentheses, etc., it is necessary to quote them, as in 
bold'’12.3". 

See also BUGS under trojf{‘\.). 
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NAME 

error — analyze and disperse compiler error messages 
SYNOPSIS 

error [ -n ] [ -s ] [ -q ] [ -v ] [ -t suffixlist ] [ -I ignorefile ] [ 
name ] 

DESCRIPTION 

Error analyzes and optionally disperses the diagnostic error messages 
produced by a number of compilers and language processors to the 
source file and line where the errors occurred. It can replace the pain¬ 
ful, traditional methods of scribbling abbreviations of errors on paper, 
and permits error messages and source code to be viewed simultaneously 
without machinations of multiple windows in a screen editor. 

Error looks at the error messages, either from the specified file name or 
from the standard input, and attempts to determine which language pro¬ 
cessor produced each error message, determines the source file and line 
number to which the error message refers, determines if the error mes¬ 
sage is to be ignored or not, and inserts the (possibly slightly modified) 
error message into the source file as a comment on the line preceeding 
to which the line the error message refers. Error messages which can’t 
be categorized by language processor or content are not inserted into 
any file, but are sent to the standard output. Error touches source files 
only after all input has been read. By specifying the —q query option, the 
user is asked to confirm any potentially dangerous (such as touching a 
file) or verbose action. Otherwise error proceeds on its merry business. 
If the —t touch option and,associated suffix list is given, error will restrict 
itself to touch only those files with suffices in the suffix list. Error also 
can be asked (by specifying —v) to invoke v'i(l) on the files in which error 
messages were inserted; this obviates the need to remember the names 
of the files with errors. 

Error is intended to be run with its standard input connected via a pipe 
to the error message source. Some language processors put error mes¬ 
sages on their standard error file; others put their messages on the stan¬ 
dard output. Hence, both error sources should be piped together into 
error. For example, when using the csh syntax, 

make | & error —q —v 
or. for the Bourne shell, 

make 2><Scl | error —q —v 

will analyze all the error messages produced by whatever programs make 
runs. 

Error knows about the error messages produced by: make, cc, cpp, ccom, 
as, Id, lint, pi, pc and f?7. Error knows a standard format for error mes¬ 
sages produced by the language processors, so is sensitive to changes in 
these formats. For all languages except Pascal, error messages are res¬ 
tricted to be on one line. Some error messages refer to more than one 
line in more than one files; error will duplicate the error message and 
insert it at all of the places referenced. 

Error will do one of six things with error messages. 
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synchronize 

Some language processors produce short errors describing 
which file it is processing. Error uses these to determine the file 
name for languages that don't include the file name in each 
error message. These synchronization messages are consumed 
entirely by error. 

discard Error messages from lint that refer to one of the two lint 
libraries, /usr/lib/llib-lc and /usr/lib/llib-port are discarded, 
to prevent accidently touching these libraries. Again, these 
error messages are consumed entirely by error. 

nullify Error messages from lint can be nullified if they refer to a 
specific function, which is known to generate diagnostics which 
are not interesting. Nullified error messages are not inserted 
into the source file, but are written to the standard output. The 
names of functions to ignore are taken from either the file 
named .errorrc in the users’s home directory, or from the file 
named by the —I option. If the file does not exist, no error mes¬ 
sages are nullified. If the file does exist, there must be one 
function name per line. 

not file specific 

Error messages that can’t be intuited are grouped together, 
and written to the standard output before any files are 
touched. They will not be inserted into any source file. 

file specific 

Error message that refer to a specific file, but to no specific 
line, are written to the standard output when that file is 
touched. 

true errors 

Error messages that can be intuited are candidates for inser¬ 
tion into the file to which they refer. 

Only true error messages are candidates for inserting into the file they 
refer to. Other error messages are consumed entirely by error or are 
written to the standard output. Elrror inserts the error messages into 
the source file on the line preceeding the line the language processor 
found in error. Each error message is turned into a one line comment 
for the language, and is internally flagged with the string "###” at the 
beginning of the error, and ”%%%" at the end of the error. This makes 
pattern searching for errors easier with an editor, and allows the mes¬ 
sages to be easily removed. In addition, each error message contains the 
source line number for the line the message refers to. A reasonably for¬ 
matted source program can be recompiled with the error messages still 
in it, without having the error messages themselves cause future errors. 
For poorly formatted source programs in free format languages, such as 
C or Pascal, it is possible to insert a comment into another comment, 
which can wreak havoc with a future compilation. To avoid this, format 
the source program so there are no language statements on the same 
line as the end of a comment. 

Options available with error are: 
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—n Do not touch any files; all error messages are sent to the standard 
output. 

—q The user is queried whether s/he wants to touch the file. A “y” or 
"n" to the question is necessary to continue. Absence of the —q 
option implies that all referenced files (except those refering to dis¬ 
carded error messages) are to be touched. 

—V After all files have been touched, overlay the visual editor vi with it 
set up to edit all files touched, and positioned in the first touched 
file at the first error. If vi can’t be found, try ex or ed from standard 
places. 

—t Take the following argument as a suffix list. Files whose suffices do 
not appear in the suffix list are not touched. The suffix list is dot 
seperated, and wildcards work. Thus the suffix list; 

".c.y.foo^.h" 

allows error to touch files ending with ".c”, ".y”, ".foo*" and ".y". 

—s Print out statistics regarding the error categorization. Not too use¬ 


ful. 


Error catches interrupt and terminate signals, and if in the insertion 
phase, will orderly terminate what it is doing. 

AUTHOR 

Robert Henry 


FILES 


function names to ignore for lint error messages 
user’s teletype 


~/.errorrc 

/dev/tty 


BUGS 

Opens the teletype directly to do user querying. 

Source files with links make a new copy of the file with only one link to it. 

Changing a language processor’s format of error messages may cause 
error to not understand the error message. 

Error, since it is purely mechanical, will not filter out subsequent errors 
caused by ’fioodgating’ initiated by one syntactically trivial error. 
Humans are still much better at discarding these related errors. 

Pascal error messages belong after the lines affected (error puts them 
before). The alignment of the ’|’ marking the point of error is also dis¬ 
turbed by error. 

Eyror was designed for work on CRT’s at reasonably high speed. It is less 
pleasant on slow speed terminals, and has never been used on hardcopy 
terminals. 
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NAME 

ex — text editor 
SYNOPSIS 

ex [ - ] [ -V ] [ -t tag ] [ -r ] [ -^commarLd ] [ -1 ] [ -x ] name ... 
DESCRIPTION 

Ex is the root of a family of editors: ex and vi. Ex is a superset of ed, with 
the most notable extension being a display editing facility. Display based 
editing is the focus of vi. 

If you have a CRT terminal, you may wish to use a display based editor; in 
this case see vt(l). which is a command which focuses on the display 
editing portion of ex. 

DOCUMENTATION 

The Ex Reference Manual is a comprehensive and complete manual for 
the command mode features of ex, but you cannot learn to use the edi¬ 
tor by reading it. For an introduction to more advanced forms of editing 
using the command mode of ex see the editing documents written by 
Brian Kernighan for the editor ed; the material in the introductory and 
advanced documents works also with ex. 

An Introduction to Display Editing with Vi introduces the display editor 
vi and provides reference material on vi. The Vi Quick Reference card 
summarizes the commands of vi in a useful, functional way, and is useful 
with the Introduction. 

FOR ED USERS 

If you have used ed you will find that ex has a number of new features 
useful on CRT terminals. Intelligent terminals and high speed terminals 
are very pleasant to use with vi. Generally, the editor uses far more of 
the capabilities of terminals than ect does, and uses the terminal capabil¬ 
ity data base termcap{5) and the type of the terminal you are using from 
the variable TERM in the environment to determine how to drive your 
terminal efficiently. The editor makes use of features such as insert and 
delete character and line in its visual command (which can be abbrevi¬ 
ated vi) and which is the central mode of editing when using vt(l). There 
is also an interline editing open (o) command which works on all termi¬ 
nals. 

Ex contains a number of new features for easily viewing the text of the 
file. The z command gives easy access to windows of text. Hitting 
causes the editor to scroll a half-window of text and is more useful for 
quickly stepping through a file than just hitting return. Of course, the 
screen oriented visual mode gives constant access to editing context. 

Ex gives you more help when you make mistakes. The undo (u) command 
allows you to reverse any single change which goes astray. Ex gives you 
a lot of feedback, normally printing changed lines, and indicates when 
more than a few lines are affected by a command so that it is easy to 
detect when a command has affected more lines than it should have. 

The editor also normally prevents overwriting existing files unless you 
edited them so that you don’t accidentally clobber with a write a file 
other than the one you are editing. If the system (or editor) crashes, or 
you accidentally hang up the phone, you can use the editor recover 
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cominand to retrieve your work. This will get you back to within a few 
lines of where you left off. 

Ex has several features for dealing with more than one file at a time. You 
can give it a list of files on the command line and use the next (n) com¬ 
mand to deal with each in turn. The next command can also be given a 
list of file names, or a pattern as used by the shell to specify a new set of 
files to be dealt with. In general, filenames in the editor may be formed 
with full shell metasyntax. The metacharacter '%' is also available in 
forming filenames and is replaced by the name of the current file. 

For moving text between files and within a file the editor has a group of 
buffers, named a through z. You can place text in these named buffers 
and carry it over when you edit another file. 

There is a command tc in e® which repeats the last substitute command. 
In addition there is a confirmed substitute command. You give a range of 
substitutions to be done and the editor interactively asks whether each 
substitution is desired. 

It is possible to ignore case of letters in searches and substitutions. Ex 
also allows regular expressions which match words to be constructed. 
This is convenient, for example, in searching for the word "edit” if your 
document also contains the word "editor. 

Ex has a set of options which you can set to tailor it to your liking. One 
option which is very useful is the autoindent option which allows the edi¬ 
tor to automatically supply leading white space to align text. You can 
then use the key as a backtab and space and tab forward to align new 
code easily. 

Miscellaneous new useful features include an intelligent join (j) command 
which supplies white space between joined lines automatically, com¬ 
mands < and > which shift groups of lines, and the ability to filter por¬ 
tions of the buffer through commands such as sort. 

INVOCATION OPTIONS 

The following invocation options are interpreted by e®; 

— Suppress all interactive-user feedback. This is useful in 

processing editor scripts. 


—V 

—Mag 

—rfUe 

+command 

-1 


—X 


Invokes vi 

Edit the file containing the tag and position the editor at 
its definition. 

Recover file after an editor or system crash. If file is not 
specified a list of all saved files will be printed. 

Begin editing by executing the specified editor search or 
positioning command. 

LISP mode; indents appropriately for lisp code, the () H [[ 
and ]] commands in vi and open are modified to have 
meaning for lisp . 

Encryption mode; a key is prompted for allowing creation 
or editing of an encrypted file. 
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The name argument indicates files to be edited. 

Ex States 

Command Normal and initial state. Input prompted for by Your kill 
character cancels partial command. 

Insert Entered by a i and c. Arbitrary text may be entered. 

Insert is normaiiy terminated by line having only . on it, 
or abnormally with an interrupt. 

Open/visual Entered by open or vi, terminates with Q or ^\. 

Ex command names and abbreviarions 


abbrev 

ab 

next 

n 

unabbrev 

una 

append 

a 

number 

nu 

undo 

u 

args 

ar 

open 

o 

unmap 

unm 

change 

c 

preserve 

pre 

version 

ve 

copy 

CO 

print 

P 

visual 

vi 

delete 

d 

put 

pu 

write 

w 

edit 

e 

quit 

q 

xit 

X 

file 

f 

read 

re 

yank 

ya 

global 

g 

recover 

rec 

window 

z 

insert 

i 

rewind 

rew 

escape 

I 

join 

i 

set 

se 

Ishift 

< 

list 

1 

shell 

sh 

print next 

CR 

map 


source 

so 

resubst 

Ic 

mark 

ma 

stop 

st 

rshift 

> 

move 

m 

substitute 

s 

scroll 

-D 


Ex Command Addresses 


n 

line n 

/pat 

next with pat 

• 

current 

?pat 

previous with pat 

S 

last 

x-n 

n before x 

+ 

next 

x.y 

X through y 

— 

previous 

'X 

marked with x 

-»-n 

% 

n forward 
1,S 

* 0 

previous context 


Initializing options 
EXINIT 

SHOME/.exrc 
./.exrc 
set X 
set nox 
set x=val 
set 

set all 
set X? 


place set’s here in environment var. 

editor initialization file 

editor initialization file 

enable option 

disable option 

give value val 

show changed options 

show all options 

show value of option x 


Useful options 
autoindent 
autowrite 
ignorecase 
lisp 
list 
magic 


ai supply indent 

aw write before changing files 

ic in scanning 

( ) ( j are s-exp’s 
print ^I for tab, S at end 
. [ • special in patterns 
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nu number lines 

para macro names which start ... 
simulate smart terminal 
command mode lines 
sect macro names ... 

sw for < >. and input -'D 

sm to ) and j as typed 

slow stop updates during insert 
visual mode lines 
ws around end of buffer? 

wm automatic line splitting 

Scanning pattern formation 

beginning of line 
S end of line 

any character 

\ < beginning of word 

\ > end of word 

[sir] any char in str 

‘tsfr] ... not in str 

x—y\ ... between * and y 

* any number of preceding 

AUTHOR 

Vi and ex are based on software developed by The Unviersity of Califor¬ 
nia, Berkeley California. Computer Science Division, Department of 
Electrical Engineering and Computer Science. 


number 

paragraphs 

redraw 

scroll 

sections 

shiftwidth 

showmatch 

slowopen 

window 

wrapscan 

wrapmargin 


FILES 

/usr/lib/ex?.?strings 

/ usr / lib / ex?.?rec over 

/usr/lib/ex?.?preserve 

/elc/termcap 

JHOME/.exrc 

./.exrc 

/tmp/Exnnnnn 
/ tmp / Rxnnnnn 
/usr/preserve 


error messages 

recover command 

preserve command 

describes capabilities of terminals 

editor startup file 

editor startup file 

editor temporary 

named buffer temporary 

preservation directory 


SEE ALSO 

awk(l). ed(l). grep(l). sed(l), vi(l), termcap(5) 

CAVEATS AND BUGS 

The undo command causes all marks to be lost on lines changed and 
then restored if the marked lines were changed. 

Undo never clears the buffer modified condition. 

The z command prints a number of logical rather than physical lines. 
More than a screen full of output may result if long lines are present. 

File input/output errors don’t print a name if the command line ’ 
option is used. 

There is no easy way to do a single scan ignoring case. 

The editor does not warn if text is placed in named buffers and not used 
before exiting the editor. 
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Null characters are discarded in input files, and cannot appear in resul¬ 
tant files. 
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NAME 

excr - run a program on another system 
SYNOPSIS 

excr system program arg ... 

DESCRIPTION 

If the program name begins with a V then the program with that name 
on the named system will be run. However, if there is no ’/' then the 
directories "/bin'' and then ''/usr/bin" on the named system are 
searched for the program. When it is found, the program is executed as 
though Its root were on the named file system. If the normal "exec" 

returns errno = ENOEXEC, an attempt is made to execute the shell on the 
named file. 

This provides the user with a different facility to the one provided by 
remote execution. Thus the command "/../US/bin/who" issued on sys- 
tern Ul will print out a list of the users on Ul; to obtain a list of the users 
on U5 the excr command must be used - "excr /../U5 who". 

DIAGNOSTICS 

An error message is printe.d if the program does not exist or cannot be 
executed. 

FILES 

/usr/NCbin/excr 
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NAME 

expand, unexpand — expand tabs to spaces, and vice versa 
SYNOPSIS 

expand [ —tabstop ] [ -tabl,tab2,...,tabn ] [ file ... ] 

unexpand [ —a ] [ file ... ] 

DESCRIPTION 

Expand processes the named files or the standard input writing the stan¬ 
dard output with tabs changed into blanks. Backspace characters are 
preserved into the output and decrement the column count for tab cal¬ 
culations. Expand is useful for pre-processing character files (before 
sorting, looking at specific columns, etc.) that contain tabs. 

If a single tabstop argument is given then tabs are set tabstop spaces 
apart instead of the default 8. If multiple tabstops are given then the 
tabs are set at those specific columns. 

Unexpand puts tabs back into the data from the standard input or the 
named files and writes the result on the standard output. By default only 
leading blanks and tabs are reconverted to maximal strings of tabs. If 
the —a option is given, then tabs are inserted whenever they would 
compress the resultant file by replacing two or more characters. 
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NAME 

expr - evaluate arguments as an expression 

SYNOPSIS 

expr arg ... 

DESCRIPTION 

The arguments are taken as an expression. After evaluation, the result is 
written on the standard output. Each token of the expression is a 
separate argument. 

The operators and keywords are listed below. The list is in order of 
increasing precedence, with equal precedence operators grouped. 
expr I expr 

yields the first expr if it is neither null nor ‘O’, otherwise yields the 
second expr. 

expr & expr 

yields the first expr if neither expr is null or ‘O', otherwise yields 
‘O’. 

expr relop expr 

where relop is one of < <= = != >= >, yields *1’ if the indicated 
comparison is true, *0’ if false. The comparison is numeric if both 
expr are integers, otherwise lexicographic. 

expr + expr 

expr - expr 

addition or subtraction of the arguments. 

expr ♦ expr 

expr / expr 
expr % expr 

multiplication, division, or remainder of the arguments. 
expr : expr 

The matching operator compares the string first argument with 
the regular expression second argument; regular expression syn¬ 
tax is the same as that of eGt(l). The \(...\) pattern symbols can 
be used to select a portion of the first argument. Otherwise, the 
matching operator yields the number of characters matched (‘0’ 
on failure). 

( eayr ) 

parentheses for grouping. 

Examples: 

To add 1 to the Shell variable a: 

* a='expr $a + V 

To find the filename part (least significant part) of the pathname stored 
in variable a, which may or may not contain 

expr Sa : '.•/\(.*\)' $a 
Note the quoted Shell metacharacters. 

SEE ALSO 

ed(l), sh(l), test(l) 
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DIAGNOSTICS 

Expr returns the following exit codes: 

0 if the expression is neither null nor 'O’, 

1 if the expression is null or ‘O’, 

2 for invalid expressions. 
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NAME 

f77 — Fortran 77 compiler 
SYNOPSIS 

f77 [ option ] ... file ... 

DESCRIPTION 

F77 is the UNIX Fortran 77 compiler. It accepts several types of areu- 
merits: ^ 

Arguments whose names end with ‘.f are taken to be Fortran 77 source 
programs; they are compiled and linked. Each object program is left on 
the file in the current directory whose name is that of the source with • o’ 
substituted for ’.f’; the executable file is left on 'a.out’. 

Arguments whose names end with ’.r’ or ’.e’ are taken to be Ratfor or EFL 
source programs, respectively; these are first transformed by the 
appropriate preprocessor, then compiled by/77. 

In the same way. arguments whose names end with ’.c’ or ’.s’ are taken to 

be C or assembly source programs and are compiled or assembled and 
linked. 


Floating point is available in three different versions. The options are the 
s^ame as in cc(l) and the description in/p(3) applies. When the Motorola 
I*ast Floating Point Package is used, the compiler accepts double preci¬ 
sion declarations, but handles them silently as single precision. 

The following options have a similar meaning as in cc(l); 

—c Suppress the linking phase. 

~p Prepare object files for profiling, see j 3 ro/(l). 

-S Compile the named programs without linking, and leave the 
assembler-listing on corresponding files suffixed '.s’. 

—o output 

Name the final output file output instead of ’a.out’. 

-f[FN] 

Use Motorola Fast Floating Point (-f; default), use Motorola IEEE 
Floating Point Software (-fF). use FPP board with NSC 16081 pro¬ 
cessor (-fN). 

—K n n is a number in C notation (e.g. 4096 or 0x1000 or 010000). which 
determines the stack size of the generated program (default 2048 
bytes, cf. s<A:si 2 (l)), 

The following options are peculiar to/77; 

—onelrip 

Compile DO loops that are performed at least once if reached. 
(Fortran 77 DO loops are not performed at all if the upper limit is 
smaller than the lower limit.) 

—1 Same as ’-onetrip’. 

“U Do not convert UPPERCASE to lowercase. 

—u Make the default type of a variable ’undefined’ rather than using 

the default Fortran rules. 
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—C Compile code to check that subscripts are within declared array 

bounds. 

—w Suppress all warning messages. If the option is ’—wee', only For¬ 

tran 66 compatibility warnings are suppressed. 

—Nx Change default sizes of certain tables, 'x' is one of the letters 

q.x.s.c or n followed directly by a decimal number. The defaults 
are: 

-Nql50 Maximum number of equivalence statements 
-Nx200 Maximum number of external definitions 
-Ns701 Maximum number of statement labels 
-Nc20 Maximum nesting of control structures 

-Nn401 Size of hash table 

—12 Use short integers (2 bytes) for Fortran type integer. 

—14 Use long integers (4 bytes) for Fortran type integer (default). 

—Is Make subscripts short (default). 

—D Make subscripts long. This option must be given if an array or a 

common block is larger than 32 K bytes. It is possible to link sub¬ 
programs compiled with -Is and -11. 

—F Apply EFL and Ratfor preprocessor to relevant files, put the result 

in the file with the sufl^ changed to ‘.f’, but do not compile. 

—m Apply the M4 preprocessor to each *.r' or ’.e' file before transform¬ 

ing it with the Ratfor or EFL preprocessor. 

—Ex Use the string x as an EFL option in processing ‘.e’ files. 

—Rx Use the string x as a Ratfor option in processing *.r' files. 

Other arguments are taken to be either linker option arguments, or 
F77-compatible object programs, typically produced by an earlier run, or 
perhaps libraries of F77-compatible routines. These programs, together 
with the results of any compilations specified, are linked (in the order 
given) to produce an executable program with name 'a.out'. 

FILES 

file.[fresc] 
file.o 
a.out 

/usr/lib/f77passlfTp 
/usr/Iib/f77passlieee 
/lib/cl 
/lib/c2 

/usr/Iib/libF77fIp.a 
/usr/lib/libF77mot.a 
/usr/lib/libF77nsc.a 
/usr/lib/libI77*.a 
/lib/libfTp.a 
/lib/libmot.a 
/lib/libnsc.a 
/lib/libc.a 

SEE ALSO 

S. I. Feldman, P. J. Weinberger, A Portable Fortran 77 Compiler 


input file 

object file 

linked output 

compiler pass for FFP 

compiler pass for IEEE floating point 

pass 2 

pass3 

intrinsic function library FFP 
intrinsic function library Motorola IEEE 
intrinsic function library NSC IEEE 
Fortran I/O library also for fTp, mot, nsc 
Floating point library FFP 
Floating point library Motorola IEEE 
Floating point library NSC IEEE 
C library, see section 3 
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cc(l), ld(l), prof(l) 

DIAGNOSTICS 

The diagnostics produced by /77 itself are intended to be self- 
explanatory. Occasional messages may be produced by the linker. 

BUGS 

This compiler has run the Fortran Compiler Validation Suite FCVS 76 
from the Federal Cobol Compiler Test Service (FCCTS). FCVS 78 is also 
known as "navytest". It passed all tests except two. One error is due to 
floating point accuracy. The other error is that a format statement must 
be given before an "assign’-statement that assigns the label of the for- 
mat statement to an integer variable. 

If a common block is defined in one source file and incompletely initial¬ 
ized in another one. the block is without warning truncated to the initial¬ 
ized size. 
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NAME 

factor — factor a number 

SYNOPSIS 

factor [ number ] 

DESCRIPTION 

When factor is invoked without an argument, it waits for a number to be 
typed in. If you type in a positive number less than 2“ (about 7.2xl0‘*) it 
will factor the number and print its prime factors; each one is printed 
the proper number of times. Then it waits for another number. It exits if 
it encounters a zero or any non-numeric character. 

If factor is invoked with an argument, it factors the number as above and 
then exits. 

Maximum time to factor is proportional to >fri and occurs when n is 
prime or the square of a prime. It takes 1 minute to factor a prime near 
10‘* on a PDP-11. 

DIAGNOSTICS 

"Ouch” for input out of range or for garbage input. 
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NAME 

file — determine file type 

SYNOPSIS 

file file ... 

DESCRIPTION 

performs a series of tests on each argument in an attempt to classify 
it. If an argument appears to be ascii, file examines the first 512 bytes 
and tries to guess its language. 

BUGS 

It often makes mistakes. In particular it often suggests that command 
files are C programs. 


Page 1 


February 17, 1984 













FIND (1) 


HUNIX 


FIND (1) 


NAME 

find — find files 
SYNOPSIS 

find [ —1 maxlvl ] path-name-list expression 
DESCRIPTION 

Hnd recursively descends the directory hierarchy for each path name in 
the paf/i-name-iisf (i.e., one or more path names) seeking files that 
match a boolean expression written in the primaries given below. If —1 
maxlvl is specified, the directory walk will be at most maxlvl levels deep. 
In the descriptions, the argument n is used as a decimal integer where 
+n means more than n. -n means less than n and n means exactly n. 

-name/ife True if file matches the current file name. Normal shell 

argument syntax may be used if escaped (watch out for r 

? and •). 

-permonum True if the file permission flags exactly match the octal 
number onum (see chmod{l)). If onum is prefixed by a 
rmnus sign, more flag bits (017777, see sfaf(2)) become 
significant and the flags are compared: 

(flags&onum)==onum 

—type c True if the type of the file is c, where c is b, c, d, p, or f for 

block special file, character special file, directory, fifo 
(a.k.a named pipe), or plain file. 

-links n True if the file has n links. 

—user uname True if the file belongs to the user uname. If uname is 
numeric and does not appear as a login name in the 
/etc/passwd file, it is taken as a user ID. 

-group gname 

True if the file belongs to the group gname. If gname is 
numeric and does not appear in the /etc/group file, it is 
taken as a group ID. 

True if the file is n blocks long (512 bytes per block). 

True if the file has been accessed in n days. 

True if the file has been modified in n days. 

True if the file has been changed in n days. 

True if the executed cmd returns a zero value as exit 
status. The end of cmd must be punctuated by an 
escaped semicolon. A command argument is replaced 
by the current path name. 

Like —exec except that the generated command line is 
printed with a question mark first, and is executed only if 
the user responds by typing y. 

Always true; causes the current path name to be printed. 

Write the current file on device in cpio (5) format (5120 
byte records). 
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—size n 
—atime n 
—mtime n 
—cUme n 
—exec cmd 

—ok cmd 

—print 
—cpio device 
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-newer/lie True if the current file has been modified more recently 
than the argument 

( expression ) True if the parenthesized expression is true (parentheses 
are special to the shell and must be escaped). 

The primaries may be combined using the following operators (in order of 
decreasing precedence): 

1) The negation of a primary (! is the unary not operator). 

2) Concatenation of primaries (the and operation is implied by the jux¬ 
taposition of two primaries). 

3) Alternation of primaries (—o is the or operator). 

EXAMPLE 

To remove all files named a.out or ♦.o that have not been accessed for a 
week: 

find / \ ( —name a.out —o —name '*. 0 ’ \) —atime +7 —exec rm {j \: 

FILES 

/etc/passwd, /etc/group 
SEE ALSO 

cpio(l), sh(l). test(l). stat(2). cpio(5). fs(5). 
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NAME 

finger — user information lookup program 
SYNOPSIS 

finger [ options ] name ... 

DESCRIPTION 

By default finger lists the login name, full name, terminal name and write 
status (as a before the terminal name if write permission is denied), 
idle time, login time, and office location and phone number (if they are 
known) for each current UNIX user. (Idle time is minutes if it is a single 
integer, hours and minutes if a is present, or days and hours if a’d’ is 
present.) 

A longer format also exists and is used by finger whenever a list of peo¬ 
ples names is given. (Account names as well as first and last names of 
users are accepted.) This format is multi-line, and includes all the infor¬ 
mation described above as well as the user’s home directory and login 
shell, any plan which the person has placed in the file .plan in their home 
directory, and the project on which they are working from the file .pro¬ 
ject also in the home directory. 

Finger options include: 

—m Match arguments only on user name. 

—1 Force long output format. 

—p Suppress printing of the .plan files 

—s Force short output format. 

FILES 

/etc/utmp 
/etc/passwd 
/usr/adm/lastlog 
~/.plan 
~/.project 

SEE ALSO 

w(l), who(l) 

AUTHOR 

Earl T. Cohen 

BUGS 

Only the first line of the .project file is printed. 

The encoding of the geos field is UCB dependent — it knows that an office 
•197MC’ is ’ISTM Cory Hall', and that ’SagBE' is ’SSOB Evans Hall’. 

A user information data base is in the works and will radically alter the 
way the information that finger uses is stored. Finger will require exten¬ 
sive modification when this is implemented. 


who file 

for users names, offices, ... 

last login times 

plans 

projects 


Page 1 


February 17,1984 









I 


‘•. 7 .rn.; .' , . * ,7'."'. u"'^'-> 5 ' • ■ ,•■' t: ' 


* ; :-••/ ' •■ .; ‘5 :'’>■ ' t <! :'7.a •:>?'l ’. ' 

. ;■ . .' b;-:- ^''r:ba. '.’.n:"/''' -■ainiaV'"b't 

■•:f ;\.:bv7. :ir :j - b^^lq'c'.it ^b” .■■ 

• : a.: ::i<r-.l x^dJ na/.b.^ . v- a 


.I'-Jica la.a..■ f 


b.:>‘7nol ^■. 

4 v.i 3 .iC, -V. b'. 

. a*. ^;; • 







SObtO ,1; 

..:^;i..r - 'V.: .... 

.. i ' ■ .. .’ : 

,hr^'‘^q:.-b f; 


. ■'! r?v ?■[ ^nav;.] 

-ebb' •, 

■.•■b:b'. Vbb^ i 

Hlianeib. 

V’• nalb'. ,. ii 

v<v b-' ‘^ 


:>V 

.:i.,.;;^-v biv^ 

y.nid ■■ 





.bf: 

bl.. .^-b 



:.• "bwb;’^ :■= 












FMT(l) 


MUNIX 


FMT(l) 


NAME 

fmt — simple text formatter 

SYNOPSIS 

fmt [ name ... ] 

DESCRIPTION 

Pmt is a simple text formatter which reads the concatenation of input 
files (or standard input if none are given) and produces on standard out¬ 
put a version of its input with lines as close to 72 characters long as pos¬ 
sible. The spacing at the beginning of the input lines is preserved in the 
output, as are blank lines and interword spacing. 

Pmt is meant to format mail messages prior to sending, but may also be 
useful for other simple tasks. For instance, within visual mode of the ex 
editor (e.g. vi) the command 
!{fmt 

will reformat a paragraph, evening the lines. 

SEE ALSO 

nrofl(l), mail(l) 

AUTHOR 

Kurt Shoens 

BUGS 

The program was designed to be simple and fast — for more complex 
operations, the standard text processors are likely to be more appropri¬ 
ate. 
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NAME 

fold — fold long lines for finite width output device 
SYNOPSIS 

fold [ —width ] [ file ... ] 

DESCRIPTION 

Fold is a filter which will fold the contents of the specified files, or the 
standard input if no files are specified, breaking the lines to have max¬ 
imum width width. The default for width is 80. Width should be a multi¬ 
ple of 8 if tabs are present, or the tabs should be expanded using 
exjiand^l) before coming to fold. 

SEE ALSO 

expand(l) 

BUGS 

If underlining is present it may be messed up by folding. 
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NAME 

fpr - printer filter for FORTRAN output 
SYNOPSIS 

fpr [ file ... ] 

DESCRIPTION 

is a printer filter for output of FORTRAN programs. The first charac¬ 
ter of each line is interpreted as a format control character. The follow¬ 
ing characters are recognized: 

<space> 

single line feed, 

1 form feed, 

0 double line feed, 

+ no line feed, i.e. print over previous line. 

Other characters are treated like a space, i.e. single line feed, also are 

totally empty lines. 

Input is read from the files given as arguments or from standard input, a 
file name of - is also interpreted as standard input. 

Output is written to standard output. 

EXAMPLE 

The command line 
a.out I fpr I Ipr 

prints the output to channel 6 of the FORTRAN program a.out with for¬ 
mat control on the line printer. 

BUGS 

It is not possible to print more than 66 lines per page due to Ipr setting. 
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NAME 

from — who is my mail from? 

SYNOPSIS 

from [ —s sender ] [ user ] 

DESCRIPTION 

From prints out the mail header lines in your mailbox file to show you 
who your mail is from. If user is specified, then user’s mailbox is exam¬ 
ined instead of your own. If the -s option is given, then only headers for 
mail sent by sender are printed. 

FILES 

/usr/mail/* 


SEE ALSO 

mail(l). prmail(l) 
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NAME 

get - get a version of an SCCS file 
SYNOPSIS 

(4)'-“i t-i [-(p]i 

DESCRIPTION 

generates an ASCII text file from each named SCCS file according to 
the specifications given by its keyletter arguments, which begin with - 
The arguments may be specified in any order, but all keyletter areu- 
ments apply to all named SCCS files. If a directory is named^cef behaves 

tLl'no^SCCs'flf.s ir '^‘'■==‘“0' xere specified as a named file, except 
11 hj sees files (last component of the path name does not beeln with 

Tame M an'’scc?fi7°?' 7°’' 7' standard input is taken to be the 

oblTfires are SenUy ignt'ed™""' 

The generated text is normally written into a file called the g-file whose 

???? fif the keyletter arguments is explained below as though only one 

fnn? ^ ® If processed, but the effects of any keyletter argument 

applies independently to each named file. gument 

/Z?entification string (SID) of the version (delta) of an 
sees file to be retrieved. Table 1 below shows, for the most 
f'^^^sion of an SCCS file is retrieved (as well 
as the SID of the version to be eventually created by delta(l) if 

"“e keyletter is also used), as a function of the SID 
specified. 

—ccutoff Cutoff date-time, in the form: 

YY[MM[DD[HH[MM[SS]]]]] 

No changes (deltas) to the SCCS file which were created after 
cufo^ date-time are included in the generated 
ASCII text file. Units omitted from the date-time default to 
their maximum possible values: that is. -c7502 is equivalent to 
C750228235959. Any number of non-numeric characters 
may separate the various 2 digit pieces of the cutoff date-time 

» « o!I specify a cutoff date in the form: 

♦ 9|22:25''. Note that this implies that one may use 

the %E% and identification keywords (see below) for 

nested gets within, say the input to a send(IC) command: 

~!get ''-c%E% %U%'' s.file 

Indicates that the get is for the purpose of editing or making a 

a subsequent use of 
6 a(l). The e keyletter used in a get for a particular ver- 
Sion (SID) of the SCCS file prevents further gets for editing on 
the same SID until delta is executed or the j (joint edit) flag is 
set in the SCCS file (see adpiin(l)). Concurrent use of get —e 
for different SIDs is always allowed. 


—e 


9 
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If the g-file generated by get with an —e keyletter is acciden¬ 
tally ruined in the process of editing it. it may be regenerated 
^jy re-executing the get command with the k keyletter in 
place of the -e keyletter. 

sees file protection specified via the ceiling, floor, and author¬ 
ized user list stored in the SeeS file (see admin(l)) are 
enforced when the —e keyletter is used. 

-b Used with the -e keyletter to indicate that the new delta 

should have an SID in a new branch as shown in Table 1. This 
keyletter is ignored if the b flag is not present in the file (see 
admm(l)) or if the retrieved delta is not a leaf delta. (A leaf 
delta is one that has no successors on the SCCS file tree.) 

Note: A branch delta may always be created from a non-leaf 
delta. 

-Hist A list of deltas to be included (forced to be applied) in the 
creation of the generated file. The list has the following syn¬ 
tax: 

<list> ::= <range> 1 <list> . <range> 

<range> ::= SID | SID — SID 

SID, the SCCS Identification of a delta, may be in any form 
shown in the "SID Specified” column of Table 1. Partial SIDs 
are interpreted as shown in the "SID Retrieved” column of 
Table 1. 

-xlist A list of deltas to be. excluded (forced not to be applied) in the 
creation of the generated file. See the -i keyletter for the list 
format. 

—Suppresses replacement of identification keywords (see below) 
in the retrieved text by their value. The —k keyletter is 
implied by the —e keyletter. 

—l[p] Causes a delta summary to be written into an l-file. If —Ip is 

used then an l-file is not created: the delta summary is writ¬ 
ten on the standard output instead. See FILES for the format 
of the l-file. 

—p Causes the text retrieved from the SCCS file to be written on 

the standard output. No g-file is created. All output which 
normally goes to the standard output goes to file descriptor 2 
instead, unless the —s keyletter is used, in which case it disap¬ 
pears. 

—s Suppresses all output normally written on the standard out¬ 

put. However, fatal error messages (which always go to file 
descriptor 2) remain unaffected. 

-m Causes each text line retrieved from the SCCS file to be pre¬ 

ceded by the SID of the delta that inserted the text line in the 
SCCS file. The format is: SID. followed by a horizontal tab. fol- 
lowed by the text line. 

-n Causes each generated text line to be preceded with the %M% 

identification keyword value (see below). The format is: %M% 
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value, followed by a horizontal tab. followed by the text line. 
When both the —m and —n keyletters are used, the format is; 
%M% value, followed by a horizontal tab, followed by the —m 
keyletter generated format. 

Suppresses the actual retrieval of text from the SCCS file. It is 
primarily used to generate an I-file, or to verify the existence 
of a particular SID. 

Used to access the most recently created ("top”) delta in a 
given release (e.g., —rl), or release and level (e.g., —rl.2). 

The delta sequence number of the SCCS file delta (version) to 
be retrieved (see sccsfile{5)). This keyletter is used by the 
C07n6(l) command; it is not a generally useful keyletter, and 
users should not use it. If both the — r and —a keyletters are 
specified, the —a keyletter is used. Care should be taken when 
using the —a keyletter in conjunction with the — e keyletter, as 
the SID of the delta to be created may not be what one 
expects. The — r keyletter can be used with the —a and —e 
keyletters to control the naming of the SID of the delta to be 
created. 

For each file processed, get responds (on the standard output) with the 
SID being accessed and with the number of lines retrieved from the SCCS 
file. 

If the —e keyletter is used, the SID of the delta to be made appears after 
the SID accessed and before the number of lines generated. If there is 
more than one named file or if a directory or standard input is named, 
each file name is printed (preceded by a new-line) before it is processed. 
If the —i keyletter is used included deltas are listed following the nota¬ 
tion '‘Included”; if the —x keyletter is used, excluded deltas are listed fol¬ 
lowing the notation "Excluded". 


TABLE 1. Determination of SCCS Identification String 

SID* 

Specified 

—b Keyletter 
Usedt 

Other 

Conditions 

SID 

Retrieved 

SID of Delta 
to be Created 

nonet 

no 

R defaults to mR 

mR.mL 

mR.(mL+l) 

nonet 

yes 

R defaults to mR 

mR.mL 

mR.mL.(mB + l).l 

R 

no 

R > mR 

mR.mL 

R.l*** 

R 

no 

R = mR 

mR.mL 

mR.(mL + l) 

R 

yes 

R > mR 

mR.mL 

mR.mL.(mB + l).l 

R 

yes 

R = mR 

mR.mL 

mR.mL.(mB + l).l 

R 

— 

R < mR and 

R does nof exist 

hR.mL** 

hR.mL.(mB + l). 1 

R 

— 

Trunk succ.# 
in release > R 
and R exists 

R.mL 

R.mL.(mB + l).l 

R.L 

no 

No trunk succ. 

R.L 

R.(L + 1) 

R.L 

yes 

No trunk succ. 

R.L 

R.L.(mB + l).l 

R.L 

— 

Trunk succ. 
in release ^ R 

R.L 

R.L.(mB + l).l 


-g 

-t 

—aseg-no. 
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** 


*•* 


••R" •‘L” "B" and "S'' are the "release”, "level", "branch”, and 
"sequence" components of the SID, respectively: "m" means "max¬ 
imum" Thus, for example, "R.mL" means "the maximum level 
number within release R": "R.L.(mB+l).l” means "the first sequence 
number on the new branch (i.e., maximum branch number plus one] 
of level L within release R”. Note that if the SID, specified is of the 
form "R.L”, "R.L.B", or "R.L.B.S”, each of the specified components 

must exist. , , .1 xu 

“hR” is the highest existing release that is lower than the specined, 

nonexistent, release R. , . 1 

This is used to force creation of Ihe first delta in a new release. 

The — b keyletter is effective only if the b flag (see admin [I)) is 
present in the file. An entry of - means "irrelevant”. ^ 
t This case applies if the d (default SID) flag is not present in the flle^ 
If the d flag is present in the file, then the SID obtained from the d 
flag is interpreted as if it had been specified on the command line. 
Thus, one of the other cases in this table applies. 

Identifying information is inserted into the text retrieved from the SCCS 
flle by repldiCing identification keywords Yiilh their value wherever they 
occur. The following keywords may be used in the text stored in an SCCS 
file: 


# 

t 


Keyword 

%M% 


% 1 % 

%R% 

%L% 

%B% 

%S% 

%D% 

%H% 

%T% 

%E% 

%G% 

%U% 

%Y% 

%F% 

%P% 

%Q% 


Value . , 

Module name: either the value of the m flag in the file (see 
admm(l)), or if absent, the name of the SCCS file with the lead¬ 
ing s. removed. „ ^ • j 

sees identification (SID) (%R%.%L%.%B%.%S%) of the retrieved 

text. 

Release. 

Level. 

Branch. 

Sequence. 

Current date (YY/MM/DD). 

Current date (MM/DD/YY). 

Current time (HH:MM:SS). 

Date newest applied delta was created (YY/MM/DD). 

Date newest applied delta was created (MM/DD/YY). 

Time newest applied delta was created (HH:MM:SS). 

Module type: value of the t flag in the SCCS file (see acimin(l);. 
SCCS file name. 

Fully qualified SCCS file name. 

The value of the q flag in the file (see admin(1)). 
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Current line number. This keyword is intended for identifying 
messages output by the program such as "this shouldn’t have 
happened” type errors. It is nof intended to be used on every 
line to provide sequence numbers. 

The 4-character string @(#) recognizable by iu;iaf(l). 

A shorthand notation for constructing what{l) strings for UNIX 
program files. ?;W% = %Z%%M%<horizontal-tab>%I% 

Another shorthand notation for constructing what{\) strings 
for non-UNIX program files. %A% = %Z%%Y% %M% %]%%Z% 

FILES 

Several auxiliary files may be created by get, These files are known 
generically as the g-file, L-file, p-flle, and z-file. The letter before the 
hyphen is called the tag. An auxiliary file name is formed from the SCCS 
file name: the last component of all SCCS file names must be of the form 
s.module-name, the auxiliary files are named by replacing the leading s 
with the tag. The g-file is an exception to this scheme: the g-file is 
named by removing the s. prefix. For example, s.xyz.c, the auxiliary file 
names would be xyz.c, l.xyz.c, p.xyz.c, and z.xyz.c. respectively. 

The g-file, which contains the generated text, is created in the current 
directory (unless the —p keyletter is used). A g-file is created in all 
cases, whether or not any lines of text were generated by the get. It is 
owned by the real user. If the -k keyletter is used or implied its mode is 
644; otherwise its mode is 444. Only the real user need have write per¬ 
mission in the current directory. 

The l-file contains a table showing which deltas were applied in generat¬ 
ing the retrieved text. The l-file is created in the current directory if the 
—1 keyletter is used; its mode is 444 and it is owned by the real user. Only 
the real user need have write permission in the current directory. 

Lines in the l-file have the following format: 

a. A blank character if the delta was applied; 

• otherwise. 

b. A blank character if the delta was applied or wasn’t applied 
and ignored; 

• if the delta wasn’t applied and wasn’t ignored. 

c. A code indicating a ‘‘special’’ reason why the delta was or 
was not applied: 

“I’’: Included. 

"X”: Excluded. 

"C”: Cut off (by a —c keyletter). 

d. Blank. 

e. SCCS identification (SID). 

f. Tab character. 

g. Date and time (in the form YY/MM/DD HH:MM:SS) of creation. 

h. Blank. 

i. Login name of person who created delta. 

The comments and MR data follow on subsequent lines, indented 
one horizontal tab character. A blank line terminates'each entry. 

The p-file is used to pass information resulting from a get with an —e 
keyletter along to delta. Its contents are also used to prevent a 


7.C7, 

ZZ7. 

ZKZ 

ZAZ 
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subsequent execution of get with an —e keyletter for the same SID until 
delta is executed or the joint edit flag, j. (see admm(l)) is set in the SCCS 
file. The p-file is created in the directory containing the SCCS file and 
the effective user must have write permission in that directory. Its mode 
is 644 and it is owned by the effective user. The format of the p-file is: 
the gotten SID. followed by a blank, followed by the SID that the new delta 
will have when it is made, followed by a blank, followed by the login name 
of the real user, followed by a blank, followed by the date-time the get 
was executed, followed by a blank and the —i keyletter argument if it was 
present, followed by a blank and the -x keyletter argument if it was 
present, followed by a new-line. There can be an arbitrary number of 
lines in the p-file at any time; no two lines can have the same new delta 
SID. 

The z-file serves as a lock-out mechanism against simultaneous updates. 
Its contents are the binary (2 bytes) process ID of the command (i.e., get) 
that created it. The z-file is created in the directory containing the SCCS 
file for the duration of get. The same protection restrictions as those for 
the p-file apply for the z-file. The z-file is created mode 444. 

SEE ALSO 

admin(l), delta(l), help(l), prs(l). what(l), sccsfile(5). 

Source Code Control System User's Guide by L. E. Bonanni and C. A. 
Salemi. 

DIAGNOSTICS 

Use help{\) for explanations. 

BUGS 

If the effective user has write permission (either explicitly or implicitly) 
in the directory containing the SCCS files, but the real user doesn’t, then 
only one file may be named when the —e keyletter is used. 
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NAME 

getopt — parse command options 
SYNOPSIS 

set — 'getopt optstring X*' 

DESCRIPTION 

Getopt is used to break up options in command lines for easy parsing by 
shell procedures, and to check for legal options. Optstring is a string of 
recognized option letters (see getopt(3C)); if a letter is followed by a 
colon, the option is expected to have an argument which may or may not 
be separated from it by white space. The special option — is used to 
delimit the end of the options. Getopt will place — in the arguments at 
the end of the options, or recognize it if used explicitly. The shell argu¬ 
ments (31 S2 . . .) are reset so that each option is preceded by a — and in 
its own shell argument; each option argument is also in its own shell 
argument. 

DIAGNOSTICS 

Getopt prints an error message on the standard error when it encounters 
an option letter not included in optstring. 

EXAMPLE 

The following code fragment shows how one might process the arguments 
for a command that can take the options a and b, and the option o, 
which requires an argument. 

set — 'getopt abo: S*' 

if [ S? != 0 ] 

then 

echo SUSAGE 
exit 2 
fi 

for i in S* 
do 

case Si in 

-a I -b) FLAG=Si: shift;; 

—o) 0ARG=S2; shift; shift;; 

—) shift; break;; 

esac 

done 

This code will accept any of the following as equivalent; 

cmd —aoarg file file 
cmd —a —o arg file file 
cmd —oarg —a file file 
cmd —a —oarg — file file 

SEE ALSO 

sh(l), getopt(3C). 
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NAME 

graph — draw a graph 

SYNOPSIS 

graph [ options ] 

DESCRIPTION 

Graph with no options takes pairs of numbers from the standard input as 
abscissas and ordinates of a graph. Successive points are connected by 
straight lines. The graph is encoded on the standard output for display 
by the <pfof(lG) filters. 

If the coordinates of a point are followed by a non-numeric string, that 
string is printed as a label beginning on the point. Labels may be sur¬ 
rounded with quotes ", in which case they may be empty or contain 
blanks and numbers; labels never contain new-lines. 

The following options are recognized, each as a separate argument: 

—a Supply abscissas automatically (they are missing from the 

input); spacing is given by the next argument (default 1). A 
second optional argument is the starting point for automatic 
abscissas (default 0 or lower limit given by —x). 

—b Break (disconnect) the graph after each label in the input. 

—c Character string given by next argument is default label for 

each point. 

—g Next argument is grid style, 0 no grid, 1 frame with ticks, 2 full 

grid (default). 

—1 Next argument is label for graph. 

—m Next argument is mode (style) of connecting lines: 0 discon¬ 

nected, 1 connected (default). Some devices give distinguish¬ 
able line styles for other small integers (e.g., the Tektronix 
4014: 2=dotted, 3=dash-dot, 4=short-dash, 5=long-dash). 

—s Save screen, don't erase before plotting. 

—X [ 1 ] If 1 is present, x axis is logarithmic. Next 1 (or 2) arguments are 
lower (and upper) x limits. Third argument, if present, is grid 
spacing on x axis. Normally these quantities are determined 
automatically. 

—y [ 1 ] Similarly for y. 

—h Next argument is fraction of space for height. 

—w Similarly for width. 

—r Next argument is fraction of space to move right before plot¬ 

ting. 

—u Similarly to move up before plotting. 

—t Transpose horizontal and vertical axes. (Option —x now applies 

to the vertical axis.) 

A legend indicating grid range is produced with a grid unless the —s 
option is present. If a specified lower limit exceeds the upper limit, the 
axis is reversed. 

SEE ALSO 

graphics(lG), spline(lG), tplot(lG). 

BUGS 

Graph stores all points internally and drops those for which there isn’t 
room. 
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Segments that run out of bounds are dropped, not windowed. 
Logarithmic axes may not be reversed. 
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NAME 


grep, egrep, fgrep - search a file for a pattern 
SYNOPSIS 

grep [ options ] expression [ files ] 
egrep [ options ] [ expression ] [ files ] 
fgrep [ options ] [ strings ] [ files ] 
DESCRIPTION 


Commands of the grep family search the input files (standard input 
default) for lines matching a pattern. Normally, each line found is copLd 
to the standard output. Gr^p patterns are limited regular expressions in 
he Style of ed(l); it uses a compact non-deterministic algorithm. £brep 
patterns are full regular expressions-, it uses a fast deterministic algo¬ 
rithm that sometimes needs exponential space. Fgrep patterns are fixed 
strxngs-, it is fast and compact. The following options are recognized; 

All lines but those matching are printed. 

on^y)'^*^^ lines matched in their entirety are printed (Jgrep 

Only a count of matching lines is printed. 

Only the names of files with matching lines are listed (once) 
separated by new-lines. \ 

Each line is preceded by its relative line number in the file. 


—V 
—X 


-1 


—n 
-b 


—s 


* ✓-. Hi HIC llic. 

Each line is preceded by the block number on which it was found. 
This is sometimes useful in locating disk block numbers by context. 
The error messages produced for nonexistent or unreadable files 
are suppressed {grep only). 

—e expression 

Same as a simple expression argument, but useful when the expres¬ 
sion begins with a - (does not work with grep) 

—f file 

The regular expression {egrep) or strings list {fgrep) is taken from 
the fiLe, 


^ all cases, the file name is output if there is more than one input file. 
Care should be taken when using the characters S. [. |, (, ), and \ in 

expression, because they are also meaningful to the shell. It is safest to 
enclose the entire expression argument in single.quotes 

Fgrep searches for lines that contain one of the strings separated by 
new-lines, j 


Egrep accepts regular expressions as in ed{l), except for \( and \), with 

the addition of: 

1. A regular expression followed by + matches one or more 
occurrences of the regular expression. 

2. A regular expression followed by ? matches 0 or 1 occurrences of 
the regular expression, 

3. Two regular expressions separated by | or by a new-line match 
strings that are matched by either. 

4. A regular expression may be enclosed in parentheses () for group- 
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The order of precedence of operators is [], then •?+, then concatena' 
tion, then 1 and new-line. 

SEE ALSO 

ed(l). sed(l), sh(l). 


DIAGNOSTICS 

Exit status is 0 if any matches are found, 1 if none, 2 for syntax errors or 
inaccessible files (even if matches were found). 


Ideally there should be only one grep, but we don’t know a single algo¬ 
rithm that spans a wide enough range of space-time tradeoffs. 

Lines are limited to 256 characters; longer lines are truncated. 

Egrep does not recognize ranges, such as [a—z], in character classes. 
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NAME 

head — give first few lines 
SYNOPSIS 

head [ —count ] [ file ... ] 

DESCRIPTION 

This filter gives the first counf lines of each of the specified files, or of 
the standard input. If count is omitted it defaults to 10. 

SEE ALSO 

tail(l) 
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NAME 

help — ask for help 

SYNOPSIS 

help [args] 

DESCRIPTION 

Help finds information to explain a message from a command or explain 
the use of a command. Zero or more arguments may be supplied. If no 
arguments are given, help will prompt for one. 

The arguments may be either message numbers (which normally appear 
in parentheses following messages) or command names, of one of the fol¬ 
lowing types: 

type 1 Begins with non-numerics, ends in numerics. The 
non-numeric prefix is usually an abbreviation for the 
program or set of routines which produced the mes¬ 
sage (e.g., ge6, for message 6 from the get command). 

type 2 Does not contain numerics (as a command, such as 
get) 

type 3 Is all numeric (e.g., 212) 

The response of the program will be the explanatory information related 
to the argument, if there is any. 

When all else fails, try “help stuck". 

FILES 

/usr/lib/help directory containing files of message text. 

DIAGNOSTICS 

Use help{l) for explanations. 
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NAME 

hp - handle special functions of HP 2640 and 2621-series terminals 

SYNOPSIS 

hp [ -e ] [ -m ] 

DESCRIPTION ' 

Hp supports special functions of the Hewlett-Packard 2640 series of ter¬ 
minals, with the primary purpose of producing accurate representations 
of most nroff{l) output. Typical uses are; 

nroff —h files ... | hp 
nroff —h —s ... files | hp 

In the latter case, nroff will stop at the beginning of each page (including 
the first) and wait for you to hit line-feed (control-j) before resuming 
output. 

Regardless of the hardware options on your terminal, hp tries to do sen¬ 
sible things with underlining and reverse line-feeds. If the terminal has 
the “display enhancements" feature, subscripts and superscripts can be 
indicated in distinct ways. If it has the “mathematical-symbol” feature, 
Greek and other special characters can be displayed. 

The fiags are as follows: 

—e It is assumed that your terminal has the “display enhancements” 

feature, and so maximal use is made of the added display modes. 
Overstruck characters are presented in the Underline mode. 
Superscripts are shown in Half-bright mode, and subscripts in 
Half-bright. Underlined mode. If this fiag is omitted, hp assumes 
that your terminal lacks the "display enhancements” feature. In 
this case, all overstruck characters, subscripts, and superscripts 
are displayed in Inverse Video mode, i.e., dark-on-light, rather 
than the usual light-on-dark. 

—m Requests minimization of output by removal of new-lines. Any 

contiguous sequence of 3 or more new-lines is converted into a 
sequence of only 2 new-lines: i.e., any number of successive blank 
lines produces only a single blank output line. This allows you to 
retain more actual text on the screen. 

With regard to Greek and other special characters, hp provides the same 
set as does 300{l), except that “not” is approximated by a right arrow, 
and only the top half of the integral sign is shown. The display is ade¬ 
quate for examining output fromnegn(l). 

DIAGNOSTICS 

“line too long” if the representation of a line exceeds 1,024 characters. 
The exit codes are 0 for normal termination, 2 for all errors. 

SEE ALSO 

300(1), col(l). greek(l), neqn(l). tbl(l), trofT(l). 

BUGS 

An "overstriking sequence” is defined as a printing character followed by 
a backspace followed by another printing character. In such sequences, 
if either printing character is an underscore, the other printing charac¬ 
ter is shown underlined or in Inverse Video; otherwise, only the first 
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printing character is shown (again, underlined or in Inverse Video). 
Nothing special is done if a backspace is adjacent to an ASCII control 
character. Sequences of control characters (e.g.. reverse line-feeds, 
backspaces) can make text “disappear”; in particular, tables generated 
by f6i(l) that contain vertical lines will often be missing the lines of text 
that contain the “foot" of a vertical line, unless the input to hp is piped 

through coi(l). . ^ . » 

Although some terminals do provide numerical superscript characters. 

no attempt is made to display them. 
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NAME 

hyphen — find hyphenated words 
SYNOPSIS 

hyphen files 

DESCRIPTION 

Hyphen finds all the hyphenated words \n files and prints them on the 
standard output. If no arguments are given, the standard input is used 
1 nus hyphen may be used as a filter. 

BUGS 

Hyphen can't cope with hyphenated italic (i.e., underlined) words; it will 
often miss them completely, or mangle them. 

Hyphen occasionally gets confused, but with no ill effects other than 
spurious extra output. 
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NAME 

id — print user and group IDs and names 

SYNOPSIS 

id 

DESCRIPTION 

Id writes a message on the standard output giving the user and group IDs 
and the corresponding names of the invoking process. If the effective 
and real IDs do not match, both are printed. 

SEE ALSO 

logname(l), getuid(2), getgid(2). 
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NAME 

ifprolog - The prolog interpreter system 
SYNOPSIS 

ifprolog [ -c file ] [ -Is Size ] [ -gs Size ] [ -ts Size ] [ -dbs Size 1 f 
-fs Size J name ... j l 

DESCRIPTION 

ifprolog is a prolog interpreter written in C. 

The options are: 

—c File 

The file File will be consulted, after the initialization of the inter¬ 
preter. This option may occur several times. 

—Is Size 

A local stack area of Size bytes will be allocated. 

—gs Size 

A global stack area of Size bytes will be allocated. 

—ts Size 

A trail area of Size bytes will be allocated. 

—dbs Size 

A datebase area of Size bjrtes will be allocated. 

—fs Size 

A functor/atom area of Size bytes will be allocated. 

SEE ALSO 

Clocksin. W.F., Mellish. O.S.: Programming in Prologj Springer Verlag Ber¬ 
lin Heidelberg 1981 e s 

IF/Prolog User's Manual, Interface Computer GmbH 

LIMITATIONS 

ifprolog needs at least 300 Kbyte memory 

FILES 

/usr/lib/ifprolog/pl/boot needed for initialisation 
/usr/lib/ifprolog/pl/init needed for initialisation 
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NAME 

indent — indent and format a C program source 
SYNOPSIS 

indent ifile [ ofile ] [ args ] 

DESCRIPTION 

The arguments that can be specified follows. They may appear before or 
after the file names. 


ifile 

Input file specification. 

ofile 

Output file specification. 

If omitted, then the indented formatted file will be written back 
into the input file, and there will be a "back-up" copy of ifile 
written in the current directory. For an ifile named 
"/blah/blah/file", the backup file will be named ".Bfile". (It will 
only be listed when the ‘-a’ argument is specified in Is.) If ofile is 
specified, indent checks to make sure it is different from ifile. 

-Innn 

Maximum length of an output line. The default is 75. 

-ennn 

-cdnnn 

The column in which comments will start. The default is 33. 

The column in which comments on declarations will start. The 
default is for these comments to start in the same column as 
other comments. 

-innn 

The number of spaces for one indentation level. The default is 
4. 

-dj,-ndj 

-dj will cause declarations to be left justified, -ndj will cause 
them to be indented the same as code. The default is -ndj. 

-v,-nv 

-V turns on "verbose" mode, -nv turns it off. When in verbose 
mode, indent will report when it splits one line of input into two 
or more lines of output, and it will give some size statistics at 


completion. The default is -nv. 

-bc.-nbc If -be is specified, then a newline will be forced after each 


-dnnn 

comma in a declaration, -nbc will turn off this option. The 
default is -be. 

This option controls the placement of comments which are not 
to the right of code. Specifying -d2 means that such comments 
will be placed two indentation levels to the left of code. The 
default -do lines up these comments with the code. See the sec¬ 
tion on comment indentation below. 

-br,-bl 

Specifying -bl will cause complex statements to be lined up like 
this: 

if(...) 

code 


Specifying -br (the default) will make them look like thi 

if (...) I 

code 

j 
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You may set up your own 'profile' of defaults to indent by creating the 
file '/usr/your-name/.indent.pro' (where your-name is your login name) 
and including whatever switches you like. If indent is run and a profile 
file exists, then it is read to set up the program's defaults. Switches on 
the command line, though, will always over-ride profile switches. The 
profile file must be a single line of not more than 127 characters. The 
switches should be seperated on the line by spaces or tabs. Indent is 
intended primarily as a C program indenter. Specifically, indent will; 

> indent code lines 

> align comments 

> insert spaces around operators where necessary 

> break up declaration lists as in "int a,b,c:". 

It will not break up long statements to make them fit within the max¬ 
imum line length, but it will flag lines that are too long. Lines will be bro¬ 
ken so that each statement starts a new line, and braces will appear 
alone on a line. (See the -br option to inhibit this.) Also, an attempt is 
made to line up identifiers in declarations. 

Multi-line expressions 

Indent will not break up complicated expressions that extend over multi¬ 
ple lines, but it will usually correctly indent such expressions which have 
already been broken up. Such an expression might end up looking like 
this: 

X = 

( 

(Arbitrary parenthesized expression) 

+ 

( 

(Parenthesized expression) 

♦ 

(Parenthesized expression) 

) 

); 

Comments 

Indent recognizes four kinds of comments. They are straight text, "box" 
comments, UNIX-style comments, and comments that should be passed 
thru unchanged. The action taken with these various types is as follows: 

"Box" comments: The DSG documentation standards specify that boxes 
will be placed around section headers. Indent assumes that any com¬ 
ment with a dash immediately after the start of comment (i.e. "/♦-") is 
such a box. Each line of such a comment will be left unchanged, except 
that the first non-blank character of each successive line will be lined up 
with the beginning slash of the first line. Box comments will be indented 
(see below). 

Unix-style comments: This is the type of section header which is used 
extensively in the UNIX system source. If the start of comment (’/*’) 
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appears on a line by itself, indent assumes that it is a UNIX-style com¬ 
ment. These will be treated similarly to box comments, except the first 
non-blank character on each line will be lined up with the of the 

Unchanged comments; Any comment which starts in column 1 will be 
left completely unchanged. This is intended primarily for documentation 
header pages. The check for unchanged comments is made before the 
check for UNIX-style comments. 


Straight text: All other comments are treated as straight text. Indent 
will fit as many words (separated by blanks, tabs, or newlines) on a line as 
possible. Straight text comments will be indented. 

Comment indentation Box, UNIX-style, and straight text comments may 
be indented. If a comment is on a line with code it will be started in the 
comment column , which is set by the -cnnn command line parameter. 
Otherwise, the comment will be started at nnn indentation levels less 
than where code is currently being placed, where nnn is specified by the 
-dnnn command line parameter. (Indented comments will never be 
placed in column 1.) If the code on a line extends past the comment 
column, the comment will be moved to the next line. 

DIAGNOSTICS 

Diagnostic error messsages, mostly to tell that a text line has been bro¬ 
ken or is too long for the output line, will be printed on the controlling 
tty. 

FILES 

/usr/your-name/.indent.pro — profile file 

BUGS 

Doesn't know how to format "long" declarations. 
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NAME 

inews — submit news articles 
SYNOPSIS 

inews [ —h ] —I title [ — n newsgroups ] [ — e expiration date ] 
inews —p [ filename ] 
inews —C newsgroup 
DESCRIPTION 

Inews submits news articles to the USENET news network. It is intended 
as a raw interface, not as a human user interface. Casual users should 
probably use postnews{l) instead. 

The first form is for submitting user articles. The body will be read from 
the standard input. A title must be specified as there is no default. Each 
article belongs to a list of newsgroups. If the —n fiag is omitted, the list 
will default to something line general. (On ours, it is general.) If you wish 
to submit an article in multiple newsgroups, the newsgroups must be 
separated by commas and/or spaces. If not specified, the expiration 
date will be set to the local default. The -f fiag specifies the article’s 
sender. Without this flag, the sender defaults to the user’s name. If —f is 
specified, the real sender’s name will be included as a Sender line. The 
—h flag specifies that headers are present at the beginning of the article, 
and these headers should be included with the article header instead of 
as text. (This mechanism can be used to edit headers and supply addi¬ 
tional nondefault headers, but not to specify certain information, such 
as the sender and article ID, that inews itself generates.) 

When posting an article, the environment is checked for information 
about the sender. If NAME is found, its value is used for the full name, 
rather than the system value (often in /etc/passwd). This is useful if the 
system value cannot be set, or when more than one person uses the same 
login. If ORGANIZATION is found, the value overrides the system default 
organization. This is useful when a person uses a guest login and is not 
primarily associated with the organization owning the machine. 

The second form is used for receiving articles from other machines. If 
filename is given, the article will be read from the specified file; otherwise 
the article will be read from the standard input. An expiration date need 
not be present and a receival date, if present, will be ignored. 

After local installation, inews will transmit the article to all systems that 
subscribe to the newsgroups that the article belongs to. 

The third form is for creating new newsgroups. On some systems, this 
may be limited to specific users such as the super-user or news adminis¬ 
trator. (This happens on ours.) 

If the file /usr/lib/news/recording is present, it is taken as a list of 
"recordings" to be shown to users posting news. (This is by analogy to 
the recording you hear when you dial information in some parts of the 
country, asking you if you really wanted to do this.) The file contains 
lines of the form; 

newsgroups <tab> filename 
for example; 

net.all net.recording fa.all fa.recording 
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Any user posting an article to a newsgroup matching the pattern on the 
left will be shown the contents of the file on the right. The file is found in 
the LIB directory (often /usr/lib/news). The user is then told to hit DEL 
to abort or RETURN to proceed. The intent of this feature is to help com¬ 
panies keep proprietary information from accidently leaking out. 

FILES 

/ usr/spool/news/.sys.nnn 

temporary articles 
/usr/spool/news/neiDsgrroujDS /article_no. 

Articles 

/usr/spool/oldnews/ Expired articles 

/usr/lib/news/active List of known newsgroups and highest local article 

numbers in each. 

/usr/lib/news/seq Sequence number of last article 
/usr/lib/news/history 

List of all articles ever seen 
/usr/lib/news/sys System subscription list 

SEE ALSO 

Mail(l), mail(l), getdate(3), msgs(l), news(5), newsrc(5), postnews(l), 
readnews(l), recnews(l), sendnews(8), uucp(lC), uurec(8), 

AUTHORS 

Matt Glickman 
Mark Horton 
Stephen Daniel 
Tom R. Truscott 
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NAME 

intro — introduction to commands 
DESCRIPTION 

This section describes publicly accessible commands in alphabetic order. 
Certain distinctions of purpose are made in the headings: 

(1) Commands of general utility. 

(iC) Commands for communication with other systems. 

(IG) Commands used primarily for graphics and computer*aided 
design. 

System maintenance commands formerly in the category IM have been 
moved to section 8. 

SEE ALSO 

Section (6) for computer games. 

Section (8) for system maintenance programs. 

How to get started, in the Introduction. 

DIAGNOSTICS 

Upon termination each command returns two bytes of status, one sup¬ 
plied by the system giving the cause for termination, and (in the case of 
'normal' termination) one supplied by the program, see wait and exit(2). 
The former byte is 0 for normal termination, the latter is customarily 0 
for successful execution, nonzero to indicate troubles such as erroneous 
parameters, bad or inaccessible data, or other inability to cope with the 
task at hand. It is called variously 'exit code’, 'exit status’ or 'return 
code’, and is described only where special conventions are involved. 
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NAME 

join — relational database operator 
SYNOPSIS 

join [ options ] filel file2 
DESCRIPTION 

Join forms, on the standard output, a join of the two relations specified 
by the lines oifiUl and;?fe2. \l file 1 is the standard input is used. 

Filel and must be sorted in increasing ASCII collating sequence on 
the fields on which they are to be joined, normally the first in each line. 

There is one line in the output for each pair of lines in filel and fileS that 
have identical join fields. The output line normally consists of the com¬ 
mon field, then the rest of the line from filel, then the rest of the line 
from file2. 

Fields are normally separated by blank, tab or newline. In this case, mul¬ 
tiple separators count as one. and leading separators are discarded. 

These options are recognized: 

—an In addition to the normal output, produce a line for each unpair- 
able line in file n, where n is 1 or 2. 

-e s Replace empty output fields by string s. 

—jn m Join on the mth field of file n. If n is missing, use the mth field in 
each file. 

—o list 

Each output line comprises the fields specifed in list, each ele¬ 
ment of which has the form n.m, where n is a file number and m is 
a field number. 

—tc Use character c as a separator (tab character). Every appearance 

of c in a line is significant. 

SEE ALSO 

sort(l), comm(l), awk(l) 

BUGS 

With default field separation, the collating sequence is that of sorf-6; 
with —t. the sequence is that of a plain sort. 

The conventions of join, sort, comm, uniq, look and awk{l) are wildly 
incongruous. 
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NAME 

kill — terminate a process 
SYNOPSIS 

kill [ —signo ] processid ... 

DESCRIPTION 

KilL sends signal 15 (terminate) to the specified processes. This will nor¬ 
mally kill processes that do not catch or ignore the signal. The process 
number of each asynchronous process started with tc is reported by the 
Shell (unless more than one process is started in a pipeline, in which 
case the number of the last process in the pipeline is reported). Process 
numbers can also be found by using ps(l). 

The details of the kill are described in kUL{2). For example, if process 
number 0 is specified, all processes in the process group are signaled. 

The killed process must belong to the current user unless he is the 
super-user. 

If a signal number preceded by — is given as first argument, that signal is 
sent instead of terminate (see signaL{Z)). In particular "kill —9 ..." is a 
sure kill. 

SEE ALSO 

ps(l), sh(l), kill(2), signal(2). 
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NAME 

Id — loader 
SYNOPSIS 

Id [ option ] file ... 

DESCRIPTION 

Ld combines several object programs into one, resolves external refer¬ 
ences. and searches libraries. In the simplest case several object files 
are given, and Id combines them, producing an object module which can 
be either executed or become the input for a further Id run. (In the 
latter case, the —r option must be given to preserve the relocation bits.) 
The output of Ld is left on a.out. This file is made executable only if no 
errors occurred during the load. 

The argument routines are concatenated in the order specified. If any 
argument is a library, it is searched exactly once at the point it is 
encountered in the argument list. Only those routines defining an 
unresolved external reference are loaded. If a routine from a library 
references another routine in the library, and the library has not been 
processed by ranlib{\), the referenced routine must appear after the 
referencing routine in the library. Thus the order of programs within 
libraries may be important. If the first member of a library is named 

’-.SYMDEF’, then it is understood to be a dictionary for the library such 

as produced by ranLib\ the dictionary is searched iteratively to satisfy as 
many references as possible. 

The symbols •_etext*, •_edata’ and •_end’ (‘etext', ‘edata’ and ‘end’ in C) 
are reserved, and if referred to, are set to the first location above the 
program, the first location above initialized data, and the first location 
above all data respectively. It is erroneous to define these symbols. 

Ld understands several options. Except for —1, they should appear before 
the file names. They may be catenated in the usual form, e.g. id -eso 
—start prog main.o’. Ld without arguments records all valid options. 

—4 This option changes the library name ‘/lib/libi.a’ to ’/lib/libLi.a’. 
For example instead of /lib/libc.a the library /lib/libLc.a is 
searched. These libraries are assumed to include modules which 
have been produced with cc —4. 

—b This option is used to link Unix or standalone programs, where 

code is in segment 0 and data and bss in segment 1. 

—d Force definition of common storage even if the —r flag is present. 

-€ The following argument is taken to be the name of the entry point 

of the loaded program. Default is the label ‘_entry' if it exists or 

otherwise location 0. 

—lx This option is an abbreviation for the library name ’/lib/libx.a’, 
where i is a string. If that does not exist. Id tries ’/usr/lib/libi.a'. 
A library is searched when its name is encountered, so the place¬ 
ment of a —1 is significant. 

—o The name argument after —o is used as the name of the Id output 

file, instead of a.out. 
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—p This argument produces a symbol listing on stdout. 

—r Generate relocation bits in the output file so that it can be the 

subject of another Id run. This flag also prevents final definitions 
from being given to common symbols, and suppresses the 
'undefined symbol' diagnostics. 

—s 'Strip' the output, that is, remove the symbol table and relocation 

bits to save space (but impair the usefulness of the debugger). 
This information can also be removed by stTip{\). 

—t 'Trace' library searches: Print for every object module the reason 

why it is loaded. 

—u Take the following argument as a symbol and enter it as undefined 

in the symbol table. This is useful for loading wholly from a 
library, since initially the symbol table is empty and an unresolved 
reference is needed to force the loading of the first routine. 

—X Do not preserve local (non-.globl) symbols in the output symbol 
table; only enter external symbols. This option saves some space 
in the output file. 

—y This argument links objects for an unmapped address range, such 

that code and data start from OxfTSOOO and bss starts from 
OxfIaOOO. Useful for Macsbug etc. 

—K The following argument is a number in C notation, which deter¬ 

mines the stack size of the generated program (cf. stksiz{l)). 

—O This is an overlay file, only the text segment will be replaced by 

czec(2). Shared data must have the same layout as in the pro¬ 
gram overlaid. 

—Y The following argument is a number in C notation, which deter¬ 

mines the size of the symbol table (default 1009 symbols). —Y 
should be the first Id option. 

FILES 

/lib/lib*.a libraries 

/lib/libL*.a libraries with four-byte integers 

/usr/lib/lib*.a more libraries 

a.out output file 

SEE ALSO 

as(l), ar(l), cc(l), ranlib(l) 

BUGS 

Only 4-byte addresses are relocated; that is, a68 'addr:W' won't work. 
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NAME 

learn - computer aided instruction about UNIX 
SYNOPSIS 

learn [ —directory ] [ subject [ lesson [ speed ] ] ] 

DESCRIPTION 

Leam gives CAI courses and practice in the use of UNIX. To get started 
simply type Team’. The program will ask questions to find out what you 
want to do. The questions may be bypassed by naming a subject, and the 
last Lesson number that lea/m told you in the previous session. You may 
also include a speed number that was given with the lesson number (but 
without the parentheses that leam places around the speed number). If 
Lesson is , leam prompts for each lesson; this is useful for debugging. 

The subjects presently handled are 

editor 

eqn 

files 

macros 

morefiles 

C 

The special command 'bye' terminates a Leam session. 

The —directory option allows one to exercise a script in a nonstandard 
place. 

FILES 

/usr/lib/learn and all dependent directories and files 

BUGS 

The main strength of leam, that it asks the student to use the real UNIX, 
also makes possible baffling mistakes. It is helpful, especially for nonpro¬ 
grammers, to have a UNIX initiate near at hand during the first sessions. 

Occasionally lessons are incorrect, sometimes because the local version 
of a command operates in a non-standard way. Such lessons may be 
skipped, but it takes some sophistication to recognize the situation. 
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NAME 

leave - remind you when you have to leave 

SYNOPSIS 

leave [ hhmm ] 

DESCRIPTION 

Leave waits until the specified time, then reminds you that you have to 
leave. You are reminded 5 minutes and 1 minute before the actual time, 
at the time, and every minute thereafter. When you log off. Leave exits 
just before it would have printed the next message. 

The time of day is in the form hhmm where hh is a time in hours (on a 12 
or 24 hour clock). All times are converted to a 12 hour clock, and 
assumed to be in the next 12 hours. 

If no argument is given, leave prompts with "When do you have to leave?". 
A reply of newline causes leave to exit, otherwise the reply is assumed to 
be a time. This form is suitable for inclusion in a .Login or .profile. 

Leave ignores interrupts, quits, and terminates. To get rid of it you 
should either log off or use "kill —9" giving its process id. 

SEE ALSO 

calendar(l) 

AUTHOR 

Mark Horton 

BUGS 
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NAME 

lex — generator of lexical analysis programs 
SYNOPSIS 

lex [ —tvfn ] [ file ] ... 

DESCRIPTION 

Lex generates programs to be used in simple lexical analyis of text. The 
input files (standard input default) contain regular expressions to be 
searched for, and actions written in C to be executed when expressions 
• are found. 

A C source program, 'lex.yy.c' is generated, to be compiled thus: 
cc lex.yy.c —11 

This program, when run, copies unrecognized portions of the input to the 
output, and executes the associated C action for each regular expression 
that is recognized. 

The following lex program converts upper case to lower, removes blanks 
at the end of lines, and replaces multiple blanks by single blanks. 

%% 

[A—Z] putchar(yytext[0]+'a'—'A'); 

[]+8 

[ ]+ putchar(' '); 

The options have the following meanings. 

—t Place the result on the standard output instead of in file ‘lex.yy.c’. 

—V Print a one-line summary of statistics of the generated analyzer. 

—n Opposite of —v; —n is default. 

—f ‘Faster’ compilation: don’t bother to pack the resulting tables; lim¬ 

ited to small programs. 

SEE ALSO 

yacc(l) 

M. E. Lesk and E. Schmidt, LEX— Lexical Analyzer Generator 
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NAME 

line — read one line 

SYNOPSIS 

line [lineno] 

DESCRIPTION 

Line copies one line (up to a new-line) from the standard input and 
writes it on the standard output. If no parameter is given, the first line is 
read. The command Line 2 will read the second line etc. It returns an 
exit code of 1 on EOF and always prints at least a new-line. It is often 
used within shell files to read from the user's terminal. 

SEE ALSO 

sh(l), read(2). 
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NAME 

lint — a C program verifier 
SYNOPSIS 

lint [ —abchnpuvx ] file ... 

DESCRIPTION 

Lint attempts to detect features of the C program files which are likely to 
be bugs, or non-portable, or wasteful. It also checks the type usage of 
the program more strictly than the compilers. Among the things which 
are currently found are unreachable statements, loops not entered at 
the top, automatic variables declared and not used, and logical expres¬ 
sions whose value is constant. Moreover, the usage of functions is 
checked to find functions which return values in some places and not in 
others, functions called with varying numbers of arguments, and func¬ 
tions whose values are not used. 

By default, it is assumed that all the files are to be loaded together: they 
. are checked for mutual compatibility. Function definitions for certain 
libraries are available to lint] these libraries are referred to by a conven¬ 
tional name, such as '-Im', in the style of fci(l). 

Any number of the options in the following list may be used. The -D. -U. 
and —I options of cc(l) are also recognized as separate arguments. 

p Attempt to check portability to the IBM and ^6*05 dialects of C. 

h Apply a number of heuristic tests to attempt to intuit bugs, 

improve style, and reduce waste. 

b Report break statements that cannot be reached, (This is not the 
default because, unfortunately, most lex and many yacc outputs 
produce dozens of such comments.) 

V Suppress complaints about unused arguments in functions. 

X Report variables referred to by extern declarations, but never 
used. 

a Report assignments of long values to int variables. 

c Complain about casts which have questionable portability. 

u Do not complain about functions and variables used and not 
defined, or defined and not used (this is suitable for running lint 
on a subset of files out of a larger program). 

n Do not check compatibility against the standard library. 

Exit{Z) and other functions which do not return are not understood; this 
causes various lies. 

Certain conventional comments in the C source will change the behavior 
of lint: 

/•NOTREACHED*/ 

at appropriate points stops comments about unreachable code. 

/ *VARARGSn•/ 

suppresses the usual checking for variable numbers of arguments 
in the following function declaration. The data types of the first n 
arguments are checked; a missing n is taken to be 0. 
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/ *NOSTRICT* / 

shuts off strict type checking in the next expression. 

/•ARGSUSED*/ ^ ^ _ 

turns on the —v option for the next function. 


/*LINTLIBRARYe/inning of a file shuts off complaints about unused 
tions in this file. 

FILES 

/usr/lib/lint[l2] programs , 

/usr/lib/llib-lc declarations for standard functions 
/usr/lib/llib-port declarations for portable functions 

SEE ALSO 

cc(l) , 

S. C. Johnson, Lint, a CProgram Checker 


BUGS 


Lint has yet. to be made compatible with the current definition of C. 
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NAME 

lock - reserve a terminal 

SYNOPSIS 

lock 

DESCRIPTION 

Lock requests a password from the user, then prints "LOCKED" on the ter¬ 
minal and refuses to relinquish the terminal until the password is 
repeated. If the user forgets the password, he has no other recourse but 
to login elsewhere and kill the lock process. 

AUTHOR 

Kurt Shoens 

BUGS 

Should timeout after 15 minutes. 
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NAME 

login — sign on 
SYNOPSIS 

login [ name [ env-var ... ] ] 

DESCRIPTION 

The login command is used at the beginning of each terminal session and 
allows you to identify yourself to the system. It may be invoked as a 
command or by the system when a connection is first established. Also, 
it is invoked by the system when a previous user has terminated the ini¬ 
tial shell by typing a cntrL-z to indicate an "end-of-file." 

The shell handles login specially, so that login used as a command super¬ 
sedes the shell, as if "exec login" had been typed. 

Login asks for your user name (if not supplied as an argument), and, if 
appropriate, your password. Echoing is turned off (where possible) dur¬ 
ing the typing of your password, so it will not appear on the written 
record of the session. 

At some installations, an option may be invoked that will require you to 
enter a second "dialup” password. This will occur only for dial-up con¬ 
nections, and will be prompted by the message "dialup password:". Both 
passwords are required for a successful login. 

If you do not complete the login successfully within a certain period of 
time (e.g., one minute), you are likely to be silently disconnected. 

After a successful login, accounting files are updated, the procedure 
/etc/profile is performed, the message-of-the-day, if any, is printed, the 
user-ID, the group-ID, the working directory, and the command inter¬ 
preter (usually s/i.(l)) is initialized, and the file .profile in the working 
directory is executed, if it exists. These specifications are found in the 
/etc/passwd file entry for the user. The name of the command inter¬ 
preter is — followed by the last component of the interpreter's pathname 
(i.e., —sh). If this field in the password file is empty, then the default 
command interpreter, /bin/sh is used. 

The basic environment (see environ{7)) is initialized to: 

liOlAE=your-login-directory 
PATH=:/bin:/usr/bin 
S}iElL=last-field-of-passwd-entry 
UAlL=/usr/mail/your-login-name 
T2=timezone-specification 

The environment may be expanded or modified by supplying additional 
arguments to login, either at execution time or when login requests your 
login name. The arguments may take either the form xxx or xxx=yyy. 
Arguments without an equal sign are placed in the environment as 
Ln=xxx 

where n is a number starting at 0 and is incremented each time a new 
variable name is required. Variables containing an = are placed into the 
environment without modification. If they already appear in the environ¬ 
ment, then they replace the older value. There are two exceptions. The 
variables PATH and SHELL cannot be changed. This prevents people. 
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loeeine into restricted shell environments, from spawning secondary 
shells which aren't restricted. Both Login and getty understand simple 
single character quoting conventions. Typing a backslash in front of a 
character quotes it and allows the inclusion of such things as spaces and 

tabs. 


FILES 

/etc/utmp 

/etc/wtmp 

/usr / mail/your-name 

/etc/motd 

/etc/passwd 

/etc/profile 

.profile 


accounting 

accounting 

mailbox for user your-name 
message-of-the-day 
password file 
system profile 
user's login profile 


SEEALSO 

mail(l). newgrp(l). sh(l), 


su(l), passwd(5), profile(5), environ(7). 


DIAGNOSTICS ^ ^ 

Login incorrect if the user name or the password cannot be matched. 

No shell, cannot open password file, or no directory, consult a UNDC Sys¬ 


tem programming counselor. , „ . „ ., 

No utmp entry. You must exec "login" from the lowest Level sh . if you 
attempted to execute login as a command from other than the ini^.d 
shell. 
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NAME 

logname — get login name 

SYNOPSIS 

logname 

DESCRIPTION 

Logname returns the contents of the environment variable SLOGNAME, 
which is set when a user logs into the system. 

FILES 

/etc/profile 
SEE ALSO 

env(l), login(l), logname(3X), environ(7). 
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NAME 

look — find lines in a sorted list 
SYNOPSIS 

look [ —df ] string [ file ] 

DESCRIPTION 

Look consults a sorted file and prints all lines that begin with string It 
uses binary search. 

The options d and f affect comparisons as in sorf(l): 

d Dictionary’ order: only letters, digits, tabs and blanks participate in 
comparisons. 

f Fold. Upper case letters compare equal to lower case. 

If no file is specified, /usr/diet/words is assumed with collating sequence 
—df. 

FILES 

/usr/diet/words 


SEE ALSO 

sort(l), grep(l) 
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NAME 

lorder — find ordering relation for an object library 

SYNOPSIS 

lorder file ... 


DESCRIPTION 

The input is one or more object or library archive (see ar(l)) files. The 
standard output is a list of pairs of object file names, meaning that the 
first file of the pair refers to external identifiers defined in the second. 
The output may be processed by fsort(l) to find an ordering of a library 
suitable for one-pass access by fc£(l). 

This brash one-liner intends to build a new library from existing ‘.o’ files, 
ar cr library 'lorder *.o | tsort' 


FILES 



*symref, •symdef 

nm(l), sed(l), sort(l), join(l) 


SEE ALSO 

tsort(l), ld(l), ar(l) 


BUGS 

The names of object files, in and out of libraries, must end with ‘.o’; non' 
sense results otherwise. 
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NAME 

Ipctrl — set options on the parallel line printer 
SYNOPSIS 

Ipctrl [ option ... ] 

DESCRIPTION 

Lpctrl sets certain I/O options on the parallel line printer. With no argu¬ 
ment, it reports the current settings of the options. The option strings 
are selected from the following set: 

trauis switch to transparent mode 
—treois switch off transparent mode 

cap map lower case letters to upper case (capital mode) 

—cap do not map letters 
line n set page length to n (n>0). 
col n set line length to n (n>0). 
indent n 

set indent to n (n>=0). 

FILES 

/dev/lp 
SEE ALSO 

Ipr(l), ioctl(2), lp(4) 
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NAME 

Ipr — line printer spooler 
SYNOPSIS 

Ipr [ option ... ] [ name ... ] 

DESCRIPTION 

Lpr causes the named files to be queued for printing on a line printer. If 
no names appear, the standard input is assumed; thus lpr may be used 
as a filter. 

The following options may be given (each as a separate argument and in 
any order) before any file name arguments: 

—c Makes a copy of the file to be sent before returning to the user. 

—r Removes the file after sending it. 

—m When printing is complete, reports that fact by mail{l). 

—n Does not report the completion of printing by maiL{l). This is the 

default option. 

FILES 

/etc/passwd user^s identification and accounting data. 

/usr/lib/lpd line printer daemon. 

/usr/spool/lpd/* spool area. 

SEE ALSO 

lpd(8). 
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NAME 

Is, 11,1, Ir, If, lx — list contents of directory 
SYNOPSIS 

Is [ —Itasdrucifg ] name ... 

DESCRIPTION 

For each directory argument. Is lists the contents of the directory; for 
each file argument. Is repeats its name and any other information 
requested. The output is sorted alphabetically by default. When no argu¬ 
ment is given, the current directory is listed. When several arguments 
are given, the arguments are first sorted appropriately, but file argu¬ 
ments appear before directories and their contents. There are several 
options: 

—1 List in long format, giving mode, number of links, owner, size in 
bytes, and time of last modification for each file. (See below.) If 
the file is a special file the size field will instead contain the major 
and minor device numbers. 

-t Sort by time modified (latest first) instead of by name, as is nor¬ 
mal. 

—a List all entries; usually filenames starting with a are suppressed. 

—s Give size in blocks, including indirect blocks, for each entry. 

—d If argument is a directory, list only its name, not its contents 

(mostly used with —1 to get status on directory). 

—r Reverse the order of sort to get reverse alphabetic or oldest first 

as appropriate. 

—u Use time of last access instead of last modification for sorting (—t) 

or printing (—1). 

—c Use time of last modification to inode (mode, etc.) instead of last 

modification to file for sorting (—t) or printing (—1). 

—i Print i-number in first column of the report for each file listed. 

—f Force each argument to be interpreted as a directory and list the 

name found in each slot. This option turns off —1, —t, —s, and —r, 
and turns on —a; the order is the order in which entries appear in 
the directory. 

—g Give group ID instead of owner ID in long listing. 

The mode printed under the —1 option contains 11 characters which are 
interpreted as follows: the first character is 

d if the entry is a directory; 
b if the entry is a block-type special file; 
c if the entry is a character-type special file; 

— if the entry is a plain file. 

The next 9 characters are interpreted as three sets of three bits each. 
The first set refers to owner permissions; the next to permissions to oth¬ 
ers in the same user-group; and the last to all others. Within each set 
the three characters indicate permission respectively to read, to write, 
or to execute the file as a program. For a directory, ‘execute’ permission 
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is interpreted to mean permission to search the directory for a specified 
file. The permissions are indicated as follows: 


r if the file is readable; 
w if the file is writable: 

X if the file is executable: 

— if the indicated permission is not granted. 


The eroup-execute permission character is given as s if the file has set- 
group-ID mode; likewise the user-execute permission character is given 
as s if the file has set-user-ID mode. 


The last character of the mode (normally ‘x’ or -’) is t if the 1000 bit of 
the mode is on. See chmod{l) for the meaning of this mode. 


When the sizes of the files in a directory are listed, a total count of 
blocks, including indirect blocks is printed. 


The names 11. 1. Ir. If. lx should be linked to Is. LI is the sarne as Is -1; 1 
gives a compact listing of the names; Ir goes recursively through the 
directories; If puts a after the names of executable files and a / after 
the names of directories; lx. sorts names rowwise instead of columnwise. 


/etc/passwd to get user ID’s for Ts —1’.^ 
/etc/group to get group ID’s for ‘Is —g’. 

/bin/ls. /bin/11, /bin/1, /bin/lr. /bin/lf. /bin/lx 


February 17, 1904 


Page 2 







LTROFF(l) 


MUNIX 


LTROFF(l) 


NAME 

ItrofT, vtrofr - troff to the CANON LBP or the Versatec V80 
SYNOPSIS 

ItrofT/vtroff [ —F majorfont ] [ —123 minorfont ] [ —Uength ] [ —x ] 
troff arguments 

DESCRIPTION 

Ltrojf/vtroff T\xns troff {l) sending its output through various programs to 
produce typeset output on the V80 for vtroff or the CANON LBP 10 for 
Itroff. The —1 (lower case 1) option causes the output to be split onto suc¬ 
cessive pages every length inches rather than the default 11". 

The default font is a Hershey font. If some other font is desired you can 
give a —F argument and then the font name. This will place normal, italic 
and bold versions of the font on positions 1, 2. and 3. To place a font 
only on a single position, you can give an argument of the form —n. and 
the minor font name. A .r will be added to the minor font name if 
needed. Thus “vtroff —ms paper” will set a paper in the Hershey font, 
while “vtroff —F nonie —ms paper” will set the paper in the (sans serif) 
nonie font. The —x option asks for exact simulation of photo-typesetter 
output. (I.e. using the width tables for the C.A.T. photo-typesetter) 

FILES 

/usr/lib/tmac/tmac.vcatdefault font mounts and bug fixes 
/usr/lib/fontinfo/* fixes for other fonts 
/usr/lib/vfont directory containing fonts 

SEE ALSO 

troff(l), vfont(5) 

BUGS 

The Versatec fonts with a resolution of 240 dots per inch are also used 
for the LBP 10 with a resolution of 300 dots per inch. Accordingly, the 
fonts are smaller than they should be on the LBP. There exist modified 
macro packages -manl, -msl, -mel for the LBP, that set the default point 
size to 12 rather than 10. The resulting output is normally satisfactory, 
but complicated papers produced e.g. with eqn may exhibit errors. 
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NAME 

m4 — macro processor 
SYNOPSIS 

m4 [ options ] [ files ] 

DESCRIPTION 

M4 is a macro processor intended as a front end for Ratfor, C. and other 
languages. Each of the argument files is processed in order; if there are 
no files, or if a file name is —, the standard input is read. The processed 
text is written on the standard output. 

The options and their effects are as follows: 

—e Operate interactively. Interrupts are ignored and the output is 

unbuffered. Using this mode requires a special state of mind. 

—s Enable line sync output for the C preprocessor (#line ...) 

—Binf Change the size of the push-back and argument collection buffers 
from the default of 4,096. 

—Hinf Change the size of the symbol table hash array from the default of 
199. The size should be prime. 

—Sint Change the size of the call stack from the default of 100 slots. 
Macros take three slots, and non-macro arguments take one. 

—Tinf Change the size of the token buffer from the default of 512 bytes. 

To be effective, these flags must appear before any file names and before 
any —D or —U flags: 

—I>nam.e[=t;af] 

Defines name to val or to null in vaL's absence. 

—Uname 

undefines name. 

Macro calls have the form: 

name(argl,arg2.argn) 

The ( must immediately follow the name of the macro. If a defined macro 
name is not followed by a (, it is deemed to have no arguments. Leading 
unquoted blanks, tabs, and new-lines are ignored while collecting argu¬ 
ments. Potential macro names consist of alphabetic letters, digits, and 
underscore where the first character is not a digit. 

Left and right single quotes are used to quote strings. The value of a 
quoted string is the string stripped of the quotes. 

When a macro name is recognized, its arguments are collected by search¬ 
ing for a matching right parenthesis. Macro evaluation proceeds nor¬ 
mally during the collection of the arguments, and any commas or right 
parentheses which happen to turn up within the value of a nested call 
are as effective as those in the original input text. After argument col¬ 
lection, the value of the macro is pushed back onto the input stream and 
rescanned. 

M4 makes available the following built-in macros. They may be redefined, 
but once this is done the original meaning is lost. Their values are null 
unless otherwise stated. 
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define the second argument is installed as the value of the macro 
•whose name is the first argument. Each occurrence of Sn in 
the replacement text, where n is a digit, is replaced by the n- 
th argument. Argument 0 is the name of the macro; missing 
arguments are replaced by the null string: S# is replaced by 
the number of arguments; S* is replaced by a list of all the 
arguments separated by commas; is like S*, but each argu¬ 
ment is quoted (with the current quotes). 

undefine removes the definition of the macro named in its argument. 

defn returns the quoted definition of its argument(s). It is useful 

for renaming macros, especially built-ins. 

pushdef like define, but saves any previous definition. 

popdef removes current definition of its argument(s), exposing the 
previous one if any. 

ifdef if the first argument is defined, the value is the second argu¬ 

ment. otherwise the third. If there is no third argument, the 
value is null. The word unix is predefined on UNIX versions of 
m4. 

shift returns all but its first argument. The other arguments are 

quoted and pushed back with commas in between. The quot¬ 
ing nullifies the effect of the extra scan that will subsequently 
be performed. 

changequote 

change quote symbols to the first and second arguments. The 
symbols may be up to five characters long. Changequote 
without arguments restores the original values (i.e., ' '). 


changecom 


divert 


undivert 


di'vnum 

dnl 


change left and right comment markers from the default # 
and new-line. With no arguments, the comment mechanism is 
effectively disabled. With one argument, the left marker 
becomes the argument and the right marker becomes new- 
line. With two arguments, both markers are affected. Com¬ 
ment markers may be up to five characters long. 

m4 maintains 10 output streams, numbered 0-9. The final 
output is the concatenation of the streams in numerical 
order; initially stream 0 is the current stream. The divert 
macro changes the current output stream to its (digit-string) 
argument. Output diverted to a stream other than 0 through 
9 is discarded. 

causes immediate output of text from diversions named as 
arguments, or all diversions if no argument. Text may be 
undiverted into another diversion. Undiverting discards the 
diverted text. 

returns the value of the current output stream. 

reads and discards characters up to and including the next 
new-line. 
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ifelse 

has three or more arguments. If the first argument is the 
same string as the second, then the value is the third argu¬ 
ment. If not, and if there are more than four arguments, the 
process is repeated with arguments 4. 5, 6 and 7. Otherwise 
the value is either the fourth string, or. if it is not present’ 
null. 

incr 

returns the value of its argument incremented by 1. The 
value of the argument is calculated by interpreting an initial 
digit-string as a decimal number. 

deer 

eval 

returns the value of its argument decremented by 1. 

evaluates its argument as an arithmetic expression, using 32- 
bit arithmetic. Operators include +. —, *, /. %, (exponentia¬ 
tion), bitwise tc, |. and relationals; parentheses. Octal and 
hex numbers may be specified as in C. The second argument 
specifies the radix for the result; the default is 10. The third 
argument may be used to specify the minimum number of 
digits in the result. 

len 

index 

returns the number of characters in its argument. 

returns the position in its first argument where the second 
argument begins (zero origin), or -1 if the second argument 
does not occur. 

substr 

returns a substring of its first argument. The second argu¬ 
ment is a zero origin number selecting the first character: the 
third argument indicates the length of the substring. A miss¬ 
ing third argument is taken to be large enough to extend to 
the end of the first string. 

translit 

transliterates the characters in its first argument from the 
set given by the second argument to the set given by the 
third. No abbreviations are permitted. 

include 

sinclude 

returns the contents of the file named in the argument. 

is identical to include, except that it says nothing if the file is 
inaccessible. 

syscmd 

executes the UNIX command given in the first argument. No 
value is returned. 


sysval is the return code from the last call to syscmd. 

maketemp fills in a string of XXXXX in its argument with the current pro- 


m4exit 

cess ID. 

causes immediate exit from m4. Argument 1, if given, is the 
exit code; the default is 0. 

m4wrap 

argument 1 will be pushed back at final EOF; example; 
m4wrap('cleanup()') 

errprint 

dumpdef 

prints its argument on the diagnostic output file. 

prints current names and definitions, for the named items, or 
for all if no arguments are given. 


Page 3 


February 20. 1984 






M4(l) 


MUNIX 


M4(l) 


traceon with no arguments, turns on tracing for all macros (including 
built-ins). Otherwise, turns on tracing for named macros. 

traceoff turns off trace globally and for any macros specified. Macros 
specifically traced by traceon can be untraced only by 
specific calls to traceoff. 

SEE ALSO 

The M4 Macro Processor by B. W. Kernighan and D. M. Ritchie. 
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NAME 

mail, rmail — send mail to users or read mail 
SYNOPSIS 

mail [ -epqr ] [ -f file ] 
mail [ —t ] persons 
rmail [ —t ] persons 
DESCRIPTION 

A/ail without arguments prints a user's mail, message-by-message, in 
last-in, first-out order. For each message, the user is prompted with a ?, 
and a line is read from the standard input to determine the disposition of 
the message; 


<new-line> 

+ 

d 

P 

s [ files .] 
w [ files ] 

m [ persons ] 

q 

EOT (control-d) 

X 

Icommand 


Go on to next message. 

Same as <new-line>. 

Delete message and go on to next message. 

Print message again. 

Go back to previous message. 

Save message in the named files (mbox is default). 
Save message, without its header, in the named 
files (mbox is default). 

Mail the message to the named persons (yourself is 
default). 

Put undeleted mail back in the mailfile and stop. 
Same as q. 

Put all mail back in the mailfile unchanged and 
stop. 

Escape to the shell to do command. 

Print a command summary. 


The optional arguments alter the printing of the mail: 


—e causes mail not to be printed. An exit value of 0 is returned if the 

user has mail; otherwise, an exit value of 1 is returned. 

—p causes all mail to be printed without prompting for disposition. 

—q causes mail to terminate after interrupts. Normally an interrupt 

only causes the termination of the message being printed. 

—r causes messages to be printed in first-in, first-out order. 

—Ifile causes mail to use file (e.g., mbox) instead of the default mailfile. 

When persons are named, mail takes the standard input up to an end- 
of-file (or up to a line consisting of just a .) and adds it to each person’s 
mailfile. The message is preceded by the sender’s name and a postmark. 
Lines that look like postmarks in the message, (i.e., "From...’’) are pre¬ 
ceded with a >. The —t option causes the message to be preceded by all 
persons the mail is sent to. A person is usually a user name recognized 
by iogrm(l). If a person being sent mail is not recognized, or if mail is 
interrupted during input, the file dead.letter will be saved to allow editing 
and resending. 

To denote a recipient on a remote system, prefix person by the system 
name and exclamation mark (see uucp(lC)). Everything after the first 
exclamation mark in persons is interpreted by the remote system. In 
particular, if persons contains additional exclamation marks, it can 
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denote a sequence of machines through which the message is to be sent 
on the way to its ultimate destination. For example, specifying a!b!cde as 
a recipient's name causes the message to be sent to user b!cde on system 
a. System a will interpret that destination as a request to send the mes¬ 
sage to user cde on system b. This might be useful, for instance, if the 
sending system can access system a but not system b, and system a has 
access to system b. 

The maiLfile may be manipulated in two ways to alter the function of 
mail. The other permissions of the file may be read-write, read-only, or 
neither read nor write to allow different levels of privacy. If changed to 
other than the default, the file will be preserved even when empty to per¬ 
petuate the desired permissions. The file may also contain the first line: 

Forward to person 

which will cause all mail sent to the owner of the maiLfile to be forwarded 
to person. This is especially useful to forward all of a person’s mail to 
one machine in a multiple machine environment. 

Rmail only permits the sending of mail; uucp (IC) uses rmail as a secu¬ 
rity precaution. Rmail is a link to mail. 

When a user logs in, the presence of mail, if any, is indicated. Also, 
notification is made if new mail arrives while using mail. 

FILES 

/etc/passwd to identify sender and locate persons 
/usr/mail/user incoming mail for user; i.e., the mailfile 
SHOME/mbox saved mail 

SMAIL variable containing path name of mailfile 

/tmp/ma* temporary file 

/usr/mail/ •■lock 

lock for mail directory 
dead.letter unmailable text 

SEE ALSO 

login(l), uucp(lC), write(l). 

BUGS 

Race conditions sometimes result in a failure to remove a lock file. 

After an interrupt, the next message may not be printed; printing may be 
forced by typing a p. 
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NAME 

mail.nc — mail(l) using the Newcastle Connection instead of uucp. 
DESCRIPTION 

Changes, in systemlperson", "system" is now recognised as the name of 
the root of a system in the Newcastle Connection distributed naming 
tree, not a uucp(lC) system name (especially, there are no embedded "!"s 
in "system"). 

Mail.nc spawns a single mail process on each remote system to distribute 
the mail to all recipients on that system (local mail behaves as usual). 
Thus 

"mail.nc /../unixlidave /../unix2!dave /../unixllfred" calls 
"mail dave fred" on /../unixl and 
"mail dave" on /../unix2. 

SEE ALSO 

mail(l) for a full description of this command. 

BUGS 

Cannot forward messages to remote systems from within mail. 

If execution of mail on a remote system does not succeed, it is difficult to 
know what messages have been sent. 

Mail expects all "real" mail commands to live in files of the same path¬ 
name on all systems. 
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NAME 

make - maintain, update, and regenerate groups of programs 
SYNOPSIS 

'if [-Pi [-« [-y (-=1 [-rj [-nj [-bj [-e] [-m] [-tl 

l“qj l~aj [names] j l j l j 

DESCRIPTION 

The following is a brief description of all options and some special names: 

—f makefile Description file name. Makefile is assumed to be the name of 
a description file. A file name of — denotes the standard 
input. The contents of makefile override the built-in rules if 
they are present. 


-P 
—i 

-k 

—s 


—r 


—n 


-b 


—e 


-t 

-d 


Print out the complete set of macro definitions and target 
descriptions. 

Ignore error codes returned by invoked commands. This 
mode is entered if the fake target name .IGNORE appears in 
the description file. 

Abandon work on the current entry, but continue on other 
branches that do not depend on that entry. 

Silent mode. Do not print command lines before executing. 
This mode is also entered if the fake target name .SILENT 
appears in the description file. 

Do not use the built-in rules. 

No execute mode. Print commands, but do not execute 
them. Even lines beginning with an @ are printed. 

Compatibility mode for old makefiles. 

Environment variables override assignments within 
makefiles. 

Touch the target files (causing them to be up-to-date) 
rather than issue the usual commands. 

Debug mode. Print out detailed information on files and 
times examined. 


~q Question. The make command returns a zero or non-zero 

status code depending on whether the target file is or is not 
up-to-date. 

.DEFAULT If a file must be made but there are no explicit commands or 
relevant built-in rules, the commands associated with the 
name .DEFAULT are used if it exists. 

.PRECIOUS Dependents of this target will not be rempved when quit or 
interrupt are hit. 


.SILENT Same effect as the —s option. 

.IGNORE Same effect as the —i option. 

Make executes commands in triakefile to update one or more target 
names. Name is typically a program. If no —f option is present, m 2 Lkelile, 
Makefile, s.makefile, and s.Makefile are tried in order. If makefile is —, 
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the standard input is taken. More than one —f makefile argument pair 
may appear. 

Make updates a target only if it depends on files that are newer than the 
target. All prerequisite files of a target are added recursively to the list 
of targets. Missing files are deemed to be out of date. 

Makefile contains a sequence of entries that specify dependencies. The 
first line of an entry is a blank-separated, non-null list of targets, then a 
then a (possibly null) list of prerequisite files or dependencies. Text 
following a ; and all following lines that begin with a tab are shell com¬ 
mands to be executed to update the target. The first line that does not 
begin with a tab or # begins a new dependency or macro definition. Shell 
commands may be continued across lines with the <backslash><new- 
line> sequence. Sharp (#) and new-line surround comments. 

The following makefile says that pgm depends on two files a.o and b.o, 
and that they in turn depend on their corresponding source files (a.c and 
b.c) and a common file incLh: 

pgm: a.o b.o 

cc a.o b.o —o pgm 

a. o: incl.h a.c 

cc —c a.c 

b. o: incl.h b.c 

cc —c b.c 

Command lines are executed one at a time, each by its own shell. A line 
is printed when it is executed unless the —s option is present, or the 
entry .SILENT: is in makefile, or unless the first character of the com¬ 
mand is @. The —n option specifies printing without execution; however, 
if the command line has the string S(HAKE) in it, the line is always exe¬ 
cuted (see discussion of the HAKEFLAGS macro under Environment). The 
—t (touch) option updates the modified date of a file without executing 
any commands. 

Commands returning non-zero status normally terminate make. If the —i 
option is present, or the entry .IGNORE: appears in makefile, or if the line 
specifying the command begins with <tab><hyphen>. the error is 
ignored. If the —k option is present, work is abandoned on the current 
entry, but continues on other branches that do not depend on that 
entry. 

The —b option allows old makefiles (those written for the old version of 
make) to run without errors. The difference between the old version of 
make and this version is that this version requires all dependency lines 
to have a (possibly null) command associated with them. The previous 
version of make assumed if no command was specified explicitly that the 
command was null. 

Interrupt and quit cause the target to be deleted unless the target 
depends on the special name .PRECIOUS. 

Environment 

The environment is read by make. All variables are assumed to be macro 
definitions, and processed as such.’ The environment variables are pro¬ 
cessed before any makefile and after the internal rules; thus, macro 
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assignments in a makefile override environment variables. The —e option 
causes the environment to override the macro assignments in a makefile. 

The HAKEFIAGS environment variable is processed by make as containing 
any legal input option (except -f, -p. and -d) defined for the command 
line. Further, upon invocation, make "invents” the variable if it is not in 
the environment, puts the current options into it, and passes it on to 
invocations of commands. Thus. MAKEFLAGS always contains the current 
input options. This proves very useful for "super-makes”. In fact, as 
noted above, when the -n option is used, the command S(HAKE) is exe¬ 
cuted anyway; hence, one can perform a make —n recursively on a whole 
software system to see what would have been executed. This is because 
the —n is put in MAKEFLAGS and passed to further invocations of S(MAKE). 
This is one way of debugging all of the makefiles for a software project 
without actually doing anything. 

Macros 

Entries of the form string 1 = strings are macro definitions. Subsequent 
appearances of S(s<rinflfi[:su6sii=[subs<,?]]) are replaced by strings. 
The parentheses are optional if a single character macro name is used 
and there is no substitute sequence. The optional :substl=substS is a 
substitute sequence. If it is specified, all non-overlappirig occurrences of 
substl in the named macro are replaced by substS. Strings (for the pur¬ 
poses of this type of substitution) are delimited by blanks, tabs, new-line 
characters, and beginnings of lines. An example of the use of the substi¬ 
tute sequence is shown under Libraries. 

Internal Macros 

There are five internally maintained macros which are useful for writing 
rules for building targets. 

The macro 8* stands for the file name part of the current dependent 
with the suffix deleted. It is evaluated only for inference rules. 

$@ The X@ macro stands for the full target name of the current target. 
It is evaluated only for explicitly named dependencies. 

8 < The 8 < macro is only evaluated for inference rules or the .DEFAULT 
rule. It is the module which is out of date with respect to the target 
(i.e., the "manufactured” dependent file name). Thus, in the .c.o 
rule, the 8< macro would evaluate to the .c file. An example for 
making optimized .o files from .c files is: 

.c.o: 

cc —c —0 S*.c 
or: 

.c.o: 

cc —c —0 S< 

8? The 8? macro is evaluated when explicit rules from the makefile are 
evaluated. It is the list of prerequisites that are out of date with 
respect to the target; essentially, those modules which must be 
rebuilt. 

8 % The 8 % macro is only evaluated when the target is an archive library 
member of the form lib(file.o). In this case, 8 @ evaluates to lib and 
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S% evaluates to the library member, file.o. 

Four of the five macros can have alternative forms. When an upper case 
D or F is appended to any of the four macros the meaning is changed to 
"directory part" for D and "file part” for F. Thus, S(@D) refers to the 
directory part of the string S@. If there is no directory part. The only 
macro excluded from this alternative form is S?. The reasons for this are 
debatable. 

Suffixes 

Certain names (for instance, those ending with .o) have inferable prere¬ 
quisites such as .c, .s, etc. If no update commands for such a file appear 
in makefile, and if an inferable prerequisite exists, that prerequisite is 
compiled to make the target. In this case, make has inference rules 
which allow building files from other files by examining the suffixes and 
determining an appropriate inference rule to use. The current default 
inference rules are: 

.c .c~ .sh .sh~ .c.o .c'-.o .c~.c .s.o .s~.o .y.o .y~.o .l.o .l~.o 
.y.c .y~.c .l.c .c.a .c~.a .s~.a .h~.h 

The internal rules for make are contained in the source file rtiles.c for 
the make program. These rules can be locally modified. To print out the 
rules compiled into the make on any machine in a form suitable for 
recompilation, the following command is used: 

make —fp — 2>/dev/null </dev/null 

The only peculiarity in this output is the (null) string which printf{3S) 
prints when handed a null string. 

A tilde in the above rules refers to an SCCS file (see sccsfile{5)). Thus, the 
rule .c~.o would transform an SCCS C source file into an object file (.o). 
Because the s. of the SCCS files is a prefix it is incompatible with make's 
suffix point-of-view. Hence, the tilde is a way of changing any file refer¬ 
ence into an SCCS file reference. 

A rule with only one suffix (i.e. .c:) is the definition of how to build x from 
x.c. In effect, the other suffix is null. This is useful for building targets 
from only one source file (e.g., shell procedures, simple C programs). 

Additional suffixes are given as the dependency list for .SUFFIXES. Order 
is significant; the first possible name for which both a file and a rule exist 
is inferred as a prerequisite. 

The default list is: ' 

.SUFFIXES: .o .c .y .1 .s 

Here again, the above command for printing the internal rules will 
display the list of suffixes implemented on the current machine. Multiple 
suffix lists accumulate; .SUFFIXES: with no dependencies clears the list of 
suffixes. 

Inference Rules 

The first example can be done more briefly: 

pgm: a.o b.o 

cc a.o b.o —o pgm 
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a.o b.o: incl.h 

This is because make has a set of internal rules for building files. The 
user may add rules to this list by simply putting them in the makefile. 

Certain macros are used by the default inference rules to permit the 
inclusion of optional matter in any resulting commands. For example. 
CFLAGS. LFLAGS, and YFLAGS are used for compiler options to cc(l), fex(l), 
and i/acc(l) respectively. Again, the previous method for examining the 
current rules is recommended. 

The inference of prerequisites can be controlled. The rule to create a file 
with suffix .o from a file with suffix .c is specified as an entry with .c.o: as 
the target and no dependents. Shell commands associated with the tar¬ 
get define the rule for making a .o file from a .c file. Any target that has 
no slashes in it and starts with a dot is identified as a rule and not a true 
target. 

Libraries 

If a target or dependency name contains parenthesis, it is assumed to be 
an archive library, the string within parenthesis referring to a member 
within the library. Thus lib(file.o) and S(LIB)(fiJe.o) both refer to an 
archive library which contains file.o. (This assumes the LIB macro has 
been previously defined.) The expression J(LIBKfilel.o file2.o) is not 
legal. Rules pertaining to archive libraries have the form JOC.a where the 
XX is the suffix from which the archive member is to be made. An unfor¬ 
tunate byproduct of the current implementation requires the XX to be 
different from the suffix of the archive member. Thus, one cannot have 
lib(file.o) depend upon file.o explicitly. The most common use of the 
archive interface follows. Here, we assume the source files are all C type 
source: 

lib: lib(filel.o) lib(file2.o) lib(file3.o) 

©echo lib is now up to date 

.c.a: 

S(CC) -c S(CFLAGS) S< 
ar rv S@ $*.o 
rm -f S*.o 

In fact, the .c.a rule listed above is built into make and is unnecessary in 
this example. A more interesting, but more limited example of an archive 
library maintenance construction follows: 

lib: lib(filel.o) lib(file2.o) lib(file3.o) 

$(CC) -c S(CFLAGS) S(?:.o=.c) 
ar rv lib S? 

rm S? ©echo lib is now up to date 

.c.a:; 

Here the substitution mode of the macro expansions is used. The J? list 
is defined to be the set of object file names (inside lib) whose C source 
files are out of date. The substitution mode translates the .o to .c. 
(Unfortunately, one cannot as yet transform to .c^; however, this may 
become possible in the future.) Note also, the disabling of the .c.a: rule, 
which would have created each object file, one by one. This particular 
construct speeds up archive library maintenance considerably. This type 
of construct becomes very cumbersome if the archive library contains a 
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mix of assembly programs and C programs. 

FILES 

[Mmjakefile 

s.[Mm]akefile 

SEE ALSO 

\ake-A Program for Maintaining Computer Programs by S. I. Feldman. 

An Augmented Version of Make by E. G. Bradford. 

BUGS . , 

Some commands return non-zero status inappropriately; use —i to over¬ 
come the difficulty. Commands that are directly executed by the shell, 
notably cd(l), are ineffectual across new-liries in make. The syntax 
(lib(filel.o file2.o fileS.o) is illegal. You cannot build lib(me.o) from file.o. 
The macro l(a:.o=. c'^) doesn’t work. 
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NAME 

man, manprog — print entries in this manual 
SYNOPSIS 


man [ options ] [ section ] titles 
/ usr / lib / manprog file 
DESCRIPTION 


^an locates and prints the entry of this manual named title in the 
specified secfion. (For historical reasons, the word "page” is often used 
syn^onym for "entry” in this context.) The title is entered in lower 

not have a letter suffix. If no section is 
specified, ^he whole manual is searched for title and all occurrences of it 
are printed. Options and their meanings are: 


t Typeset the entry in the default format (8.5''xli"). 

—s Typeset the entry in the small format (6”x9''). 

-T4014 typeset output on a Tektronix 4014 terminal using 

-Ttek Same as -T4014. 

-Tst Print the typeset output on the MHCC STARE facility (this option 
IS not usable on most systems). 

-Tvp Print the typeset output on a Versatec printer; this option is 
not available at all UNDC System site?. 

-Tferm Format the entry using nroff and print it on the standard out¬ 
put (usually, the terminal); term is the terminal type (see 
fe7-7n(7) and the explanation below); for a list of recognized 
values of term, type help tenn2. The default value of ferm is 
450. 


w Print on the standard output only the path names of the 

entries, relative to /usr/man, or to the current directory for 
—d option. 

-d Search the current directory rather than /usr/man; requires 

the full file name (e.g., cu.lc, rather than just cu). 

-12 Indicates that the manual entry is to be produced in 12-pitch. 

May be used when STERM (see below) is set to one of 300, 300s. 
450, and 1620. (The pitch switch on the DASI 300 and 300s ter¬ 
minals must be manually set to 12 if this option is used.) 

-c Causes man to invoke cof(l); note that cof(l) is invoked 

automatically by man unless term is one of 300, 300s 450 37 
4000a. 382, 4014, tek, 1620, and X. 

~y Causes man to use the non-compacted version of the macros. 

The above options other than —d, —c, and —y are mutually exclusive, 
except that the -s option may be used in conjunction with the first four 
T options above. Any other options are passed to troff, nroff, or the 
man(7) macro package. 

When using nroff , man examines the environment variable STERH (see 
environjj)) and attempts to select options to nroff, as well as filters, that 
adapt the output to the terminal being used. The -Tterm option over¬ 
rides the value of $TERM: in particular, one should use -Tip when sending 
the output of man to a line printer. 
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Section may be changed before each title. 

As an example: 

man man 

would reproduce on the terminal this entry, as well as any other entries 
named man that may exist in other sections of the manual, e.g., man(7). 

If the first line of the input for an entry consists solely of the string: 

•\>' X 

where x is any combination of the three characters c. e, and t, and where 
there is exactly one blank between the double quote (") and x, then man 
will preprocess its input through the appropriate combination of cii;(l), 
egn(l) (negn for nroff) and tbf(l). respectively; if egn or negn are 
invoked, they will automatically read the file /usr/pub/eqnchar (see 
eqnchar{7)). 

The man command executes manprog that takes a file name as its argu¬ 
ment. Manprog calculates and returns a string of three register 
definitions used by the formatters identifying the date the file was last 
modified. The returned string has the form: 

—rdday —rmmont/i —ryj/ear 

and is passed to nroff which sets this string as variables for the man 
macro package. Months are given from 0 to 11, therefore month is 
always 1 less than the actual month. The man macros calculate the 
correct month. If the man macro package is invoked as an option to 
nroff/troff (i.e., nroff —man file), then the current day/month/year is 
used as the printed date. 

FILES 

/usr/man/man[l-8]/* the UNIX System User's Manual 

/usr/man/local/man[l-8]/* local additions 

/usr/lib/manprog calculates modification dates of entries 

SEE ALSO 

cw(l), eqn(l), nroff(l), tbl(l), tc(l), troff(l), environ(7), man(7), term(7). 

BUGS 

All entries are supposed to be reproducible either on a typesetter or on a 
terminal. However, on a terminal some information is necessarily lost. 
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NAME 

man — print sections of this manual 
SYNOPSIS 

man [ option ... ] [ chapter ] title ... 

DESCRIPTION 

Man locates and prints the section of this manual named title in the 
specified chapter. (In this context, the word 'page' is often used as a 
synonym for 'section'.) The title is entered in lower case. The chapter 
number does not need a letter suffix. If no chapter is specified, the whole 
manual is searched for title and all occurrences of it are printed. 

Options and their meanings are; 

—t Phototypeset the section using troff{\). 

—n Print the section on the standard output using nro_ff{l). 

—k Display the output on a Tektronix 4014 terminal using troff{l) and 

fc(l). 

—e Appended or prefixed to any of the above causes the manual sec¬ 

tion to be preprocessed by negn or egn(l); —e alone means —te. 

—w Print the path names of the manual sections, but do not print the 

sections themselves. 

(default) 

Copy an already formatted manual section to the terminal, or, if 
none is available, act as —n. It may be necessary to use a filter to 
adapt the output to the particular terminal’s characteristics. 

Further options, e.g. to specify the kind of terminal you have, are passed 
on to troff{l) or nroff. Options and chapter may be changed before each 
title. 

For example: 

man man 

would reproduce this section, as well as any other sections named man 
that may exist in other chapters of the manual, e.g. man(7). 

FILES 

/usr/man/man?/* 

/usr/man/cat?/* 

SEE ALSO 

nrofT(l), eqn(l). tc(l), man(7), catman(8) 

BUGS 

The manual is supposed to be reproducible either on a phototypesetter 
or on a terminal. However, on a terminal some information is necessarily 
lost. 
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NAME 

med — screen editor 
SYNOPSIS 

med file [sfartZme] [searchkey^ 

med - 

med 


DESCRIPTION 


Med calls the MED editor, which allows you to edit a file using the screen 

of your ternunal and the cursor keys, somewhat like paper, pencil and 
crsiscr. ^ 


If you call the editor by med file, the first lines of the file will be shown on 
the terminal screen. If the file does not exist, it will be created. 

Med called with no arguments continues where the previous med session 
enaea. 


Med called with argument restores only one file from the last session. 


The purpose of a screen editor is to create a new file, or to look at and 
change existing files. Med allows you to look through a file by moving a 
window (the text shown at the screen) over the files contents. The win- 
dow may be moved up, down, to the left or the right. The "cursor" (a 
blinking underline or box) shows where med is at the moment. Initially 
med IS in "replace mode", i.e. the characters typed will replace those 
.H, cursor. The cu rsor may be moved around with the arrow keys 

[lUiJ S or with IreturnI , fKomel or flaB] . 


To change text on the sc reen, th e cursor has to be placed there and the 
new characters entered. |delch| deletes the character under the cursor 
To_ir^ert characters in the middle of a word (like a’d* in ’rnidle’). pres§ 
[mse^ : then new characters will be inserted, and the rest of the line will 
move to the right. Pressing linsertl again, med is switched back to 
replace mode". 


"Function keys" are special keys along the top or the right of the key¬ 
board. Each function key does one job, such as moving some lines, look¬ 
ing for a word, or using another file. A picture of all the different func¬ 
tion keys for your terminal should be attached to this description. 

Some functions take arguments such as a number, a search string, a file 
name, etc. T o enter an argument, type the sequence; 

lenterl number or string Itunctioni . 

leaves an marker on the screen to remind you where the cur¬ 
sor was. It then goes to the bottom line on the screen to read the argu¬ 
ment. This bottom line is also used to display error messages. 
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Function keys and their meaning 
Move around: _ 


t i -» «- 

Move cursor 

±tab 

Skip to next/previous tab stop 

±page 

Move to next/previous page 

±line 

Move a halfpage up/down 

±search 

Search for a word 

goto 

Goto line n 

left 

Move window left 

right_ 

Move window rieht 


Use another file or window: 


use 

Use another file 

window 

Create/delete a window 

chwin 

Go to next window 


Cut and paste: 


backspace 

Delete character left of cursor 

close 

Delete line(s) into CLOSE buffer 

delch 

Delete character 

open 

Insert blank line(s) 

pick 

Copy text to PICK buffer 

put 

Get text from PICK buffer 

restore 

Get text from CLOSE buffer 


Others: 


do 

Run a Unix command 

enter 

Enter a parameter 

exit 

Go back to Unix 

insert 

Flip insert mode 

quote 

Control character escape 

refresh 

Refresh 

save 

Write changes to disk 

chtabs 

Change tabs 

macro 

collect keystrokes 


lenterl n 


Move the cursor n lines/columns in the direction of the 
arrow. 


February 20, 1984 


Page 2 

















































MED(l) 


MUNIX 


MED(l) 


I backspace] Remove the last character entered; thus typing 

"E R X I backspace R" is the same as "E R R". This also 
works in insert mode. 


IchtabI 

lenteri fchtabl 


Set a tab stop at the current position. 
Remove the tab stop at the current position. 


Ichwinl 

lenteri n |cnwm| 
lenteri |chwin| 


Go to the next window. 

Go to window n. Windows are numbered in the order they 
are created. 

Argument defined by the cursor is used as window 
number. 


Iciosel 


lenter 

Iciosel 

lenter 

n Iciosel 

lenter 

Iciosel 


fdelchl 


[Hoi 

lenteri 

lenteri cmd Idol 


I exit! 


a lexiti 
ad lexitl 



linserti 


Delete one line. It is saved in the CLOSE buffer. 

Delete the rest of the line, replacing it with the line below. 
Delete n lines and save them in the CLOSE buffer. 

Delete lines or a rectangle defined by the cursor and put 
it into the CLOSE buffer. 

Delete the character at the current cursor position, mov¬ 
ing the following characters to the left. 

Run the previous DO command exactly as it was given. 

Take the current line as a command for the shell. Results 
are inserted below the current line. 

cmd is a Unix command in the format [n[l]] prg [arg...] (in 
shell notation). It replaces n paragraphs (or n lines if 1 
appears) by the result of running filter prg on that text 
with given args. The replaced paragraphs are saved in the 
CLOSE buffer. 

Exit med, writing back the changed files to disk (a backup 
file named *.bak is created). 

Exit, but do not save files. 

Terminate with core dump. 

Move window to top of file. 

Move window to end of file. 

Move to the nth line. 

Argument defined by the cursor is used as line number. 

Put the editor into insert mode. Subsequent characters 
are inserted at the cursor, i.e., characters to the right of 
the cursor are not replaced but moved to the right. 
Pressing linserti again will place med back to replace 
mode. 
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Tim 


enter 

[Tim 

n |left| 

enter 

|+line| 


lenterl l+linel 

lenterl n l+line 

|-line| 


lenter 

1-linel 

lenter 

n |-line| 


lopeni 


lenterl |open| 
lenterl n [openl 
lenterl |open| 


•♦•pagel 


enlerl n |+page| 


-pagel 


enterl n |-page| 


iPickl 


Iput-I 


n Ipicki 

ipickl 


enter 

n Iput 

enter 





Iquotel 


irefreshl 


I restore I 


lenterl n |restore| 
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Move window left (about a 1/3 window width). 

Make the current column the last one (if possible). 

Move window n columns left. 

Move window down (about 1/3 page). 

Make the current line the top one. 

Move window down n lines. 

Move window up (about 1/3 page). 

Make the current line the bottom one (if possible). 

Move window up n lines. 

Open up one blank line. 

Split the line exactly at cursor position. 

Open up for n blank lines. 

Insert blank lines or rectangle in area defined by cursor. 

Move window down one page (page = size of window). 

Move down n pages. 

Move window up one page. 

Move up n pages. 

Put the current line into the PICK buffer. 

Put n lines into the PICK buffer. 

Place lines or rectangle defined by cursor in PICK buffer. 

Insert the contents of the PICK buffer (i.e. the lines or 
rectangle last "picked") at the current position. 

Insert n copies of the PICK buffer at the current position. 
Argument defined by the cursor is used as number of 
copies. 

To put a control character into the file. Iquotel echoes as 
a and whatever key on the keyboard you press next 
appears as some printable character. The two characters 
now behave as two characters on the screen, but they are 
really the single control character in the file. Changing 
the second letter changes the control character: chang¬ 
ing the preceding mark results in two ordinary charac¬ 
ters. 

Redraw terminal display. 

Insert the contents of the CLOSE buffer (i.e. the lines or 
rectangle last deleted). Insertion is done at the current 
position. 

Insert n copies of the CLOSE buffer at the current posi- 
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lenterl |restore! 


tion. 

Argument defined by the cursor is used as number of 
copies. 



I right I 
n fngHq 


Move window right (about a 1/3 window width). 
Make current column the first one. 

Move window right n columns. 


save! 

enter! name |save| 


jenterl jsavel 


Save the file shown in the current window. 

Save the file shown in the current window under filename 
name. 

Argument defined by the cursor is used as filename. 


|+search| 


[enter 

|+search| 

[enter 

word 1-l-search 

1 enter 

r-+search 


Search forwards (from the cursor towards the end of the 
file) for an occurrence of the search key last used. 

Search key used is from cursor position up to next blank. 
Search for the next occurrence of word. 

Argument defined by the cursor is used as search key. 


I-search] 


lenterl [-search] 
lenterl word |-search 
lenterl n 


l-search 


Search backwards (from the cursor towards the beginning 
of the file) for an occurrence of the search key last used. 
Search key used is from cursor position up to next blank. 
Search for the next occurrence of word. 

Argument defined by the cursor is used as search key. 


|use| 

lenterl [use| 
lenterl name |use| 


lenterl |use| 


Switch to the file previously used. 

Edit file, taking its name from cursor position up to next 
blank. 

Make the current window look at file name. A linenumber 
and/or searchkey can be specified (as in the med com¬ 
mand). 

Argument defined by the cursor is used as filename. 


[wmdow| Make another window on the real screen, so that you now 

have two, or three, or more windows. A "default file" is 
used. It may be set to look at a file using fuse] , and all 
other functions work within this little window. If the cur¬ 
sor is on the first or last column of your window the line 
separating the two windows goes horizontally on the line 
where the cursor is. The separating line goes vertically if 
the cursor is on the first or last line of your window. You 
may have two windows looking at the same file. In fact, it 


is rather neat, since changes made by editing in either 
window are reflected (at reasonable intervals) in the 
__ other window. 

I enter] | window| Delete last created window and return to the previous 

one. ^ 

lenterl name |window| Create another window displaying file name. 
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MACRO 

Typing_ 

I macro I keystrokes |macro| key 

stores the keystrokes sequence into the key. To avoid trouble, key can 
only be a printable character. From now on pressing the key is 
equivalent to typing the (long) keystrokes sequence. The sequence 
ImacrolImacrol key 

restores the original function of the key. 

Miscellaneous 

What do the funny characters in the margins mean? 

I is normal. 

; means this is past the end of the file. You may still type stuff - 
there just wasn't anything there before. Even if you type some¬ 
thing on a line, the character won’t go away until the line is rewrit¬ 
ten by the editor - but the stuff is still there. 

< There is still more text to the left (may be blanks). 

> There is still more text to the right (not only blanks). 

When editing a file for which you don’t have write permission, the 
appropriate editor functions will be disabled. 

What to do when disaster comes: 

You are protected from loss of files by the insurance system of the MED 
editor. If you edit a file named foo, the old file foo is renamed foo.bak 
(the old foo.bak is deleted). If you do not like the results of your edit, the 
UNIX command; 

mv foo.bak foo 
restores the original file foo. 

FILES 

/tmp/MED* temporary workfile (PICK- and CLOSE-buffer) 

SSA'^/MED* saves state of editing session 
/usr/lib/med/default default file 
•.bak backup files 

SEE ALSO 

termcap(5), curses(3), keycap(5) 

AUTHOR 

Dittmar Krall, Wolfratshausen, Germany. 

Inspired by the RAND Editor, Steve Zucker e.a., Santa Monica, California. 

BUGS 

Editor crashes can leave your terminal in a strange state, e.g. with dis¬ 
abled keyboard. Your system administrator should have a command to 
enable the keyboard. My panic solution is to switch terminal off/on in 
order to continue. 
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NAME 

mesg — permit or deny messages 
SYNOPSIS 

mesg [ n ] [ y ] 

DESCRIPTION 

Mesg with argument n forbids messages via u;rife(l) by revoking non-user 
write permission on the user’s terminal. Mesg with argument y reinstates 
permission. All by itself, mesg reports the current state without chane- 
ing it. ® 

FILES 

/dev/tty* 

/dev 

SEE ALSO 

write(l) 

DIAGNOSTICS 

Exit status is 0 if messages are receivable, 1 if not, 2 on error. 
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NAME 

mkdir — make a directory 
SYNOPSIS 

mkdir dirname ... 


DESCRIPTION 

directories in mode 777, as modified by umask{Z) 

maderutomaUcllyV 

Mkdir requires write permission in the parent directory. 

SEE ALSO 

rm(l) 


DIAGNOSTICS 


Mkdir returns exit code 0 if all directories were successfully made, 
erwise it prints a diagnostic and returns nonzero. 


0th- 
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NAME 

mkstr — create an error message file by massaging C source 
SYNOPSIS 

mkstr [ — ] messagefile prefix file ... 

DESCRIPTION 

Mkstr IS used to create files of error messages. Its use can make pro¬ 
grams with large numbers of error diagnostics much smaller, and reduce 
system overhead in running the program as the error messages do not 
have to be constantly swapped in and out. 

Mkstr will process each of the specified files, placing a massaged version 
of the input file in a file whose name consists of the specified prefix and 
the original name. A typical usage of mkstr would be 

mkstr pistrings xx ^.c 

This command would cause all the error messages from the C source files 
in the current directory to be placed in the file pistrings and processed 

copies of the source for these files to be placed in files whose names are 
prefixed with xx. 

To process the error messages in the source to the message file mkstr 
keys on the string -errorC" in the input stream. Each time it occurs, the 
C string starting at the is placed in the message file followed by a null 
character and a new-line character; the null character terminates the 
message so it can be easily used when retrieved, the new-line character 
makes it possible to sensibly cat the error message file to see its con¬ 
tents. The massaged copy of the input file then contains a Iseek pointer 
into the file which can be used to retrieve the message, i.e.: 

char efilname[] = '’/usr/lib/pi_strings'’; 
int efil = -1; 

error(al, a2. a3. a4) 

char buf[256]; 

if (efil < 0) ( 

efil = open(efilname, 0); 
if (efil < 0) ( 

oops: 

perror(efilname): 

exit(l); 

j 

j 

if (lseek(efil. (long) al. 0) || read(efil. buf. 256) <= 0) 
goto oops; 

^ printf(buf. a2. a3. a4); 

The optional - causes the error messages to be placed at the end of the 
specified message file for recompiling part of a large mfcsfred program. 
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SEE ALSO 

lseek(2). xstr(l) 

AUTHORS 

William Joy and Charles Haley 
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NAME 

mm - print out documents formatted with the MM macros 


SYNOPSIS 

mm [ options ] [ files ] 

DESCRIPTION 

Mm can be used to type out documents using nroff{i) and the MM text- 
n fpackage. It has options to specify preprocessing by 
f6i(l) and/or negn(l) and postprocessing by various terminal-oriented 
output filters^ The proper pipelines and the required arguments and 
1 ^t d generated, depending on the options 


Op^ons for mm are given below. Any other arguments or fiags (e g 
-rC3) are passed to nroff{l) or to MM. as appropriate. Such options can 
occur in any order, but they must appear before the files arguments. If 
no arguments are given, mm prints a list of its options. 

—Tferm Specifies the type of output terminal; for a list of recognized 

^yP® help term2. If this option is not used, mm 
will use the value of the shell variable STERII from the environ¬ 
ment (see profile(5) and envtron(7)) as the value of ferm, if 
STERM is set; otherwise, mm will use 450 as the value of ferm. If 
several terminal types are specified, the last one takes pre- 
cedence. 


12 Indicates that the document is to be produced in 12-pitch. May 
be used when STERM is set to one of 300, 300s, 450, and 1620. 
(The pitch switch on the DASI 300 and 300s terminals must be 
manually set to 12 if this option is used.) 

-c Causes mm to invoke cof (1); note that cof(l) is invoked automat¬ 
ically by mm unless term is one of 300, 300s. 450, 37, 4000A 382 
4014. tek, 1620. and X. 

—e Causes mm to invoke negn(l), 

—t Causes mm to invoke <6i(l). 

—E Invokes the—e option of nroj5'(l). 

y Causes mm to use the non-compacted version of the macros (see 
mm(7)). 

As an example (assuming that the shell variable $TERM is set in the 
environment to 450), the two command lines below are equivalent: 


mm -t -rC3 —12 ghh* 

tbl ghh* I nrofT -cm -T450-12 -h -rC3 


Mm reads the standard input when — is specified instead of any file 
names. (Mentioning other files together with - leads to disaster.) This 
option allows mm to be used as a filter, e.g.: 

cat dws I mm — 

HINTS 

1. Mm invokes nroff{l) with the -h flag. With this flag. nroJf{l) 
assumes that the terminal has tabs set every 8 character posi¬ 
tions. 

2. Use the —olist option of nroJf{l) to specify ranges of pages to be 
output. Note, however, that mm, if invoked with one or more of 
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the —e. —t. and — options, together with the —oList option of 
nroj7(l) may cause a harmless "broken pipe" diagnostic if the last 
page of the document is not specified in List. 

3. If you use the —s option of nroffil) (to stop between pages of out¬ 
put). use line-feed (rather than return or new-line) to restart the 
output. The -s option of nroff{l) does not work with the -c option 
of mm. or if mm automatically invokes coi(l) (see -c option 

above). , 

4. If you lie to mm about the kind of terminal its output will be 
printed on. you’ll get (often subtle) garbage; however, if you are 
redirecting output into a file, use the —T37 option, and then use 
the appropriate terminal filter when you actually print that file. 

ALSO 

col(l). env(l). eqn(l). greek(l). mmt(l). nroff(l). tbl(l). profile(5). mm(7). 

term(7). 

MM— Memorandum Macros by D. W. Smith and J. R. Mashey. 

Typing Documents with MM by D. W. Smith and E. M. Piskorik. 


DIAGNOSTICS ^ 

"mm: no input file” if none of the arguments is a readable file and mm is 

not used as a filter. 
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NAME 

mmchek — check usage of mm macros and eqn delimiters 
SYNOPSIS 

mmchek [files] 

DESCRIPTION 

Mmchek is a program for checking the contents of the named files for 
errors in the use of Memorandum Macros (see TnTn.(l)) and some equ^l) 
constructions. Appropriate messages are produced. The program skips 
all directories, and if no file name is given, standard input is read. 

SEE ALSO 

eqn(l), mm(l), mmt(l). 

MM—Memorandum Macros by D. W. Smith and J. R. Mashey. 

DIAGNOSTICS 

Unreadable files cause the message "Cannot open file-name''. The 
remaining output of the program is diagnostic of the source file. 

BUGS 

This is an experimental version of mmchek. Mmchek may be fully sup¬ 
ported in the future. 
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NAME 

mmt, mvt — typeset documents, view graphs, and slides 
SYNOPSIS 

mmt [ options ] [ files ] 
mvt [ options ] [ files ] 

DESCRIPTION 

These two commands are very similar to 7nm(l), except that they both 
typeset their input via troff{l), as opposed to formatting it via nroj7(l); 
mmt uses the MM macro package, while mvt uses the Macro Package for 
View Graphs and Slides. These two commands have options to specify 
preprocessing by tbl(l) and/or egn(l). The proper pipelines and the 
required arguments and flags for trojf(l) and for the macro packages are 
generated, depending on the options selected. 

Options are given below. Any other arguments or flags (e.g., —rC3) are 
passed to troff{l) or to the macro package, as appropriate. Such options 
can occur in any order, but they must appear before ihe files arguments. 
If no arguments are given, these commands print a list of their options. 

—e Causes these commands to invoke eqn{i). 

—t Causes these commands to invoke f6f(l). 

—Tst Directs the output to the MH STARE facility. 

—T4014 Directs the output to a Tektronix 4014 terminal via the fc(l) 
filter. 

—Ttek Same as —T4014. 

—a Invokes the —a option of troff{l). 

—y Causes mmt to use the non-compacted version of the macros 

(see mm(7)). No effect for mvt. 

These commands read the standard input when — is specified instead of 
any file names. 

Mvt is just a link to mmt. 

HINT 

Use the —olist option of troff{l) to specify ranges of pages to be output. 
Note, however, that these commands, if invoked with one or more of the 
—e, —t, and — options, together with the —olist option of troff{l) may 
cause a harmless “broken pipe” diagnostic if the last page of the docu¬ 
ment is not specified in list. 

SEE ALSO 

env(l), eqn(l), mm(l), tbl(l), tc(l), trofT(l), profile(5), environ(7), mm(7), 
mv(7). 

MM—Memorandum Macros by D. W. Smith and J. R. Mashey. 

Typing Documents with MM by D. W. Smith and E. M. Piskorik. 

A Macro Package for View Graphs and Slides by T. A. Dolotta and D. W. 
Smith (in preparation). 

DIAGNOSTICS 

'■m[mv]t: no input file" if none of the arguments is a readable file and 
the command is not used as a filter. 
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NAME 


] 


more, page - file perusal filter for crt viewing 
SYNOPSIS 

more [ -cdflsu ] [ -n ] [ +Linenumber ] [ +/pattern ] [ name 
page more options 
DESCRIPTION 

More is a filter which allows examination of a continuous text one screen¬ 
ful at a time on a soft-copy terminal. It normally pauses after each 
screenful, printing -More- at the bottom of the screen. If the user then 
types a carnage return, one more line is displayed. If the user hits a 

space, another screenful is displayed. Other possibilites are enumerated 
later. 


The command line options are: 

n An integer which is the size (in lines) of the window which more will 
use instead of the default. 

-c More will draw each page by beginning at the top of the screen and 
erasing each line just before it draws on it. This avoids scrolling 
the screen, making it easier to read while more is writing. This 
option will be ignored if the terminal does not have the ability to 
clear to the end of a line. 

-d More will prompt the user with the message "Hit space to continue. 
Rubout to abort" at the end of each screenful. This is useful if 
more is being used as a filter in some setting, such as a class, 
where many users may be unsophisticated. 

“"f This causes more to count logical, rather than screen lines. That 
is, long lines are not folded. This option is recommended if nroff 
output is being piped through ul, since the latter may generate 
escape sequences. These escape sequences contain characters 
which would ordinarily occupy screen postions, but which do not 
print when they are sent to the terminal as part of an escape 
sequence. Thus more may think that lines are longer than they 
actually are, and fold lines erroneously. 

1 Do not treat (form feed) specially. If this option is not given, 
more will pause after any line that contains a -L. as if the end of a 
screenful had been reached. Also, if a file begins with a form feed, 
the screen will be cleared before the file is printed. 

s Squeeze multiple blank lines from the output, producing only one 
blank line. Especially helpful when viewing nroff output, this 
option maximizes the useful information present on the screen. 

u Normally, more will handle underlining such as produced by nroff 
in a manner appropriate to the particular terminal: if the termi¬ 
nal can perform underlining or has a stand-out mode, more will 
output appropriate escape sequences to enable underlining or 
stand-out mode for underlined information in the source file. The 
—u option suppresses this processing. 

+Linenumber 

Start up at linenumber. 
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■¥ /pattern 

Slart up two lines before the line containing the regular expres¬ 
sion pattern. 

If the program is invoked as page, then the screen is cleared before each 
screenful is printed (but only if a full screenful is being printed), and k - 
1 rather than fc - 2 lines are printed in each screenful, where k is the 
number of lines the terminal can display. 

More looks in the file /etc /termcap to determine terminal characteris¬ 
tics, and to determine the default window size. On a terminal capable of 
displaying 24 lines, the default window size is 22 lines. 

More looks in the environment variable MORElo pre-set any flags desired. 
For example, if you prefer to view files using the —c mode of operation, 
the csh command setenv MORE-c or the sh command sequence MORE= -c' 
; export MORE would cause all invocations of more , including invocations 
by programs such as man and msgs , to use this mode. Normally, the 
user will place the command sequence which sets up the MORE environ¬ 
ment variable in the .cshrc or .profile file. 

If more is reading from a file, rather than a pipe, then a percentage is 
displayed along with the --More— prompt. This gives the fraction of the 
file (in characters, not lines) that has been read so far. 

Other sequences which may be typed when more pauses, and their 
effects, are as follows (i is an optional integer argument, defaulting to 1) : 

i<space> 

display i more lines, (or another screenful if no argument is given) 

-'D display 11 more lines (a “scroU”). If i is given, then the scroll size 
is set to i. 

d same as (control-D) 

iz same as typing a space except that i, if present, becomes the new 
window size. 

is skip i lines and print a screenful of lines 

if skip i screenfuls and print a screenful of lines 

q or Q Exit from more. 

= Display the current line number. 

V Start up the editor vi at the current line. 

h Help command; give a description of all the more commands, 

i/expr 

search for the i-th occurrence of the regular expression expr. If 
there are less than i occurrences of expr, and the input is a file 
(rather than a pipe), then the position in the file remains 
unchanged. Otherwise, a screenful is displayed, starting two lines 
before the place where the expression was found. The user’s erase 
and kill characters may be used to edit the regular expression. 
Erasing back past the first column cancels the search command. 

in search for the i-th occurrence of the last regular expression 
entered. 
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(single quote) Go to the point from,which the last search started. 
If no search has been performed in the current file, this command 
goes back to the beginning of the file. 

Icommand 

invoke a shell with command. The characters ’%' and '!’ in "com¬ 
mand" are replaced with the current file name and the previous 
shell command respectively. If there is no current file name. *%’ is 
not expanded. The sequences "\%" and "\!" are replaced by "%" 
and "!" respectively. 

i;n skip to the i-th next file given in the command line (skips to last 
file if n doesn’t make sense) 

i:p skip to the i-th previous file given in the command line. If this 
command is given in the middle of printing out a file, then move 
goes back to the beginning of the file. If i doesn’t make sense, 
more skips back to the first file. If more is not reading from a file, 
the bell is rung and nothing else happens. 

:f display the current file name and line number. 

;q or ;Q 

exit from more (same as q or Q). 

(dot) repeat the previous command. 

The commands take effect immediately, i.e., it is not necessary to type a 
carriage return. Up to the time when the command character itself is 
given, the user may hit the line kill character to cancel the numerical 
argument being formed. In addition, the user may hit the erase charac¬ 
ter to redisplay the --More—(xx%) message. 

At any time when output is being sent to the terminal, the user can hit 
the quit key (normally control—\). More will stop sending output, and 
will display the usual —More— prompt. The user may then enter one of 
the above commands in the normal manner. Unfortunately, some output 
is lost when this is done, due to the fact that any characters waiting in 
the terminal’s output queue are flushed when the quit signal occurs. 

The terminal is set to noecho mode by this program so that the output 
can be continuous. What you type will thus not show on your terminal, 
except for the / and ! commands. 

If the standard output is not a teletype, then more acts just like cat, 
except that a header is printed before each file (if there is more than 
one). 

A sample usage of more in previewing nroff output would be 
nroff —ms +2 doc.n | more -s 

AUTHOR 

Eric Shienbrood. minor revisions by John Foderaro and Geoffrey Peck 

FILES 

/etc/termcap Terminal data base 

/usr/lib/more.help Help file 

SEE ALSO 

csh(l), man(l). msgs(l), script(l), sh(l), environ(7) 
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NAME 

msgs - system messages and junk mail program 
SYNOPSIS 

msgs [ -fhlpq ] [ number ] [ -number ] 

DESCRIPTION 

Msgs is used to read sptem messages. These messages are sent by mail¬ 
ing to the login msgs and should be short pieces of information which 
are suitable to be read once by most users of the system. 

Msgs is normally invoked each time you login, by placing it in the file 
.Login (.profile if you use /bin/sh). It will then prompt you with the 
source and subject of each new message. If there is no subject line, the 
first few non-blank lines of the message will be displayed. If there is 
more to the message, you will be told how long it is and asked whether 
you Vish to see the rest of the message. The possible responses are; 

y type the rest of the message 

RETURN 

synonym for y. 

n skip this message and go on to the next message. 

— redisplay the last message. 

q drops you out of msgs; the next time you run the program it will 
pick up where you left off. 

s append the current message to the file "Messages” in the current 
directory; ’s—’ will save the previously displayed message. A ‘s’ or 
's-' may be followed by a space and a filename to receive the mes¬ 
sage replacing the default "Messages". 

m or ‘m—’ causes a copy of the specified message to be placed in a 
temporary mailbox and to be invoked on that mailbox. 

Both ‘m’ and ‘s’ accept a numeric argument in place of the 

Msgs keeps track of the next message you will see by a number in the file 
.msgsrc in your home directory. In the directory /usr/msgs it keeps a 
set of files whose names are the (sequential) numbers of the messages 
they represent. The file /usr/msgs/bounds shows the low and high 
number of the messages in the directory so that msgs can quickly deter¬ 
mine if there are no messages for you. If the contents of bounds is 
incorrect it can be fixed by removing it; msgs will make a new bounds file 
the next time it is run. 

Options to msgs include: 

—f which causes it not to say "No new messages.". This is useful in 

your .login file since this is often the case here. 

—q Queries whether there are messages, printing “There are new mes¬ 

sages.” if there are. The command "msgs ~q" is often used in 
login scripts. 

—h causes msgs to print the first part of messages only. 

1 option causes only locally originated messages to be reported. 
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num A message number can be given on the command line, causing 
msgs to start at the specified message rather than at the next 
message indicated by your .msgsrc file. Thus 

msgs —h 1 

prints the first part of all messages. 

—number 

will cause msgs to start number messages back from the one indi¬ 
cated by your .msgsrc file, useful for reviews of recent messages. 

—p causes long messages to be piped through 7Tiore(l). 

Within msgs you can also go to any specific message by typing its number 
when msgs requests input as to what to do. 

FILES 

/usr/msgs/* database 

~/.msgsrc number of next message to be presented 

AUTHORS 

William Joy 
David Wasley 

SEE ALSO 

mail(l), more(l) 
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NAME 


mt - magnetic tape manipulating program 
SYNOPSIS 

mt [ —t tapename ] command [ count ] 

DESCRIPTION 

Mt is used to give commands to the tape drive. If a tape name is not 
specified, /dev/nrmtO is used. If a count is not specified. 1 is assumed. 

Here are the commands: 

eof write count end-of-file marks 

fsf space forward count files 

fsr space forward count records 

bsf space backward counf files 

bsr space backward count records 

rew rewind tape 
offl rewind tape and go offline 

sw swap bytes 

nsw do not swap bytes 

len read the tape; print size of each record 


FILES 

/dev/rmt* Raw magnetic tape interface 

SEE ALSO 

tm{4), dd(l) 
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NAME 

newgrp — log in to a new group 

SYNOPSIS 

newgrp [ group ] 

DESCRIPTION 

DJexugrp changes the group identification of its caller, analogously to 
login{l). The same person remains logged in. and the current directory 
is unchanged, but calculations of access permissions to files are per¬ 
formed with respect to the new group ID. 

Newgrp without an argument changes the group identification to the 
group in the password file; in effect it changes the group identification 
back to the caller’s original group. 

A password is demanded if the group has a password and the user himself 
does not, or if the group has a password and the user is not listed in 
/etc/group as being a member of that groups 

When most users log in, they are members of the group named other. 

FILES 

/etc/group 

/etc/passwd 

SEE ALSO 

login(l), group(5). 

BUGS 

There is no convenient way to enter a password into /etc/group. 

Use of group passwords is not encouraged, because, by their very nature, 
they encourage poor security practices. Group passwords may disappear 
in the future. 
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NAME 

news — print news items 
SYNOPSIS 

news [ -a ] [ -n ] [ -s ] [ items ] 

DESCRIPTION 

News is used to keep the user informed of current events. By conven¬ 
tion, these events are described by files in the directory /usr/news. 

When invoked without arguments, news prints the contents of all current 
files in /usr/news, most recent first, with each preceded by an appropri¬ 
ate header. News stores the "currency” time as the modification date of 
a file named .news_time in the user’s home directory (the identity of this 
directory is determined by the environment variable $HOME): only files 
more recent than this currency time are considered "current.” 

The a option causes news to print all items, regardless of currency. In 
this case, the stored time is not changed. 

The —n option causes news to report the names of the current items 
without printing their contents, and without changing the stored time. 

The —s option causes. neii;s to report how many current items exist, 
without printing their names or contents, and without changing the 
stored time. It is useful to include such an invocation of news in one's 
.profile file, or in the system’s /etc/profile. 

All other arguments are assumed to be specific news items that are to be 
printed. 

If a delete is typed during the printing of a news item, printing stops and 
the next item is started. Another delete within one second of the first 
causes the program to terminate. 

FILES 

/etc/profile 

/usr/news/* 

SHOME/ .news_time 

SEE ALSO 

profile(5), environ(7). 

REMARKS 

The USENET news package is also very suitable for local news. It is much 
more powerful than this small news facility (see ineit;s(l), jDosfneiys(l), 
readnews{\)). 
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NAME 

nice, nohup — run a conimand at low priority 
SYNOPSIS 

nice [ —number ] command [ arguments ] 
nohup command [ arguments ] 

DESCRIPTION 

Nice executes command with low scheduling priority. If the number 
argument is present, the priority is incremented (higher numbers mean 
lower priorities) by that amount up to a limit of 20. The default number 
is 10. 

The super-user may run commands with priority higher than normal by 
using a negative priority, e.g. '—10’. 

Nohup executes command immune to hangup and terminate signals from 
the controlling terminal. The priority is incremented by 5. Nohup should 
be invoked from the shell with in order to prevent it from responding 
to interrupts by or stealing,the input from the next person who logs in on 
the same terminal. 

FILES 

nohup.out standard output and standard error file under nohup 

SEE ALSO 

nice(2) 

DIAGNOSTICS 

Nice returns'the exit status of the subject command. 
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NAME 

nl — line numbering filter 
SYNOPSIS 

nl [—htype] [—btype] [—ftype] [—vstart#] [—iincr] [—p] [—Inum] [—ssep] 
[—wwidth] [—nformat] file 

DESCRIPTION 

Nl reads lines from the named file or the standard input if no file is 
named and reproduces the lines on the standard output. Lines are num¬ 
bered on the left in accordance with the command options in effect. 

Nl views the text it reads in terms of logical pages. Line numbering is 
reset at the start of each logical page. A logical page consists of a 
header, a body, and a footer section. Empty sections are valid. Different 
line numbering options are independently available for header, body, and 
footer (e.g. no numbering of header and footer lines while numbering 
blank lines only in the body). 

The start of logical page sections are signaled by input lines containing 
nothing but the following character(s): 

Line contents Start of 
\;\:\: header 

\ :\; body 

\: footer 

Unless signaled otherwise, nl assumes the text being read is in a single 
logical page body. 

Command options may appear in any order and may be intermingled with 
an optional file name. Only one file may be named. The options are: 

—htype Specifies which logical page body lines are to be numbered. 

Recognized types and their meaning are: a, number all lines; t, 
number lines with printable text only; n, no line numbering; 
pstring, number only lines that contain the regular expression 
specified in string. Default type for logical page body is t (text 
lines numbered). 

—htype Same as —htype except for header. Default type for logical 
page header is n (no lines numbered). 

—ftype Same as —htype except for footer. Default for logical page 
footer is n (no lines numbered). 

—p Do not restart numbering at logical page delimiters. 

—ystart§ Starts is the initial value used to number logical page lines. 
Default is 1. 

—iincr Incr is the increment value used to number logical page lines. 
Default is 1. 

—ssep Sep is the character(s) used in separating the line number and 
the corresponding text line. Default sep is a tab. 

—wwidth Width is the number of characters to be used for the line 
number. Default width is 6. 
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—nformat 

Format is the line numbering format. Recognized values are: In, 


—-Inum 

left justified, leading zeroes supressed; m. right justified, lead¬ 
ing zeroes supressed: rz, right justified, leading zeroes kept. 
Default/ormaf is m (right justified). 

Nam is the number of blank lines to be considered as one. For 
example, —12 results in only the second adjacent blank being 
numbered (if the appropriate —ha, —ba, and/or —fa option is 
set). Default is 1. 

SEE ALSO 

pr(l). 
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NAME 

nm — print name list 
SYNOPSIS 

nm [ —gnopru ] [ file ... ] 

DESCRIPTION 

Nm prints the name list (symbol table) of each object file in the argu¬ 
ment list. If an argument is an archive, a listing for each object file in 
the archive will be produced. If no file is given, the symbols in ‘a.out’ are 
listed. 

Each symbol name is preceded by its value (blanks if undefined) and one 
of the letters U (undefined), A (absolute), T (text segment symbol). D 
(data segment symbol), B (bss segment symbol), or C (common symbol). 
If the symbol is local (non-external) the type letter is in lower case. The 
output is sorted alphabetically. 

Options are: 

—g Print only global (external) symbols. 

—n Sort numerically rather than alphabetically. 

—o Prepend file or archive element name to each output line rather 

than only once. 

—p Don’t sort; print in symbol-table order. 

—r Sort in reverse order. 

—u Print only undefined symbols. 

SEE ALSO 

ar(l). ar(5), a.out(5) 
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NAME 

notes, autoseq, nfpipe, nfprint, nfstats — a news system 
SYNOPSIS 

notes [ —sxin ] [ —t termtype ] topic 1 [ -if file ][...] 
autoseq 

nfpipe topic [ -t title ] [ "d ] [ -a ] 
nfprint [ -nn ] topic [ note list ] 
nfstats [ -s ] topic [ ... ] 
checknotes [ -qnvs ] 

DESCRIPTION 

Notes supports computer managed discussion forums. It coordinates 
access to and updates of data bases of notes and their responses. A sin¬ 
gle notesfile contains an ordered list of base notes, each of which may 
have an ordered list of responses associated with it. A nofe string con¬ 
sists of a base note and all of its responses. Separate notesfiles contain 
discussions on separate subject matters; microcomputers might be dis¬ 
cussed in a ''micronotes'' notesfile while bicycling enthusiasts make their 
comments in a "bicycle" notesfile. 

The —s option signals nofes to use the automatic sequencer. With the 
sequencer enabled, notes shows the new notes and responses since your 
last entry into that notesfile. With the sequencer enabled by —s the 
notes program will not enter notesfiles which have no new text. Specify 
—X to use the sequencer and enter notesfiles even if they have no new 
text. The —i and —n options are still more sequencing modes, —i is similar 
to —s but shows the index page instead of the first modified note. —n 
turns the sequencer off. 

Specify —t termtype to override the TERM environment variable. This 
switch is mostly used on version 6 systems. 

The -f option directs nofes to read the contents of a file for a list of 
notesfiles to scan. 

The topic list specifies which notesfiles are to be scanned. The notesfiles 
are scanned from left to right; upon finishing the first topic, the second 
is entered. The shell's meta-characters are recognized within a topic but 
must be escaped to prevent shell interpretation. Specifying "net.*" will 
yield all the notesfiles with the prefix "net.". Specify "•unix*" to read all 
notesfiles with the string "unix" in their names. Bracket and question 
mark constructs are also recognized. 

The autoseq feature allows sequencing through a list of notesfiles with 
the sequencer enabled using with a single command. The autoseq is 
(almost) syntactically equivalent to "notes -s SNFSEQ" where NFSEQ con¬ 
tains a comma separated list of notesfile names. A typical NFSEQ 
definition for the Bourne shell looks like; 

NFSEQ=''general,announce,net.*,bicycle,srg''. 

Notes and responses are entered by using an editor. The default editor is 
/bin/ed. This can be changed by setting one of the environment vari¬ 
ables NFED or EDITOR. 
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Some commonly used commands within the notesfile system are listed 
below; 


Show the next page of the note/response. 

Go the next response, if there are no more responses go to the 
next note. 

Go to the previous page of the current note/response. From 
the first page of a response, go to the previous response (or the 
base note from the first response). From the first page of a 
base note, go to the previous note. 

Go to the next note. 

Jump to the next unread note/response (when using 
sequencer). 

Jump to the next unread note, ignoring any further responses 
in the current note string (when using sequencer). 

When issued from the index page enters a new note. When 
entered from a note/response display enters a response. A 
capital-W will include the text of the currently displayed 
note/response in the new response. 

Leave the current notesfile. 

Leave the current notesfile without updating the sequencer 
information. 

control-z 

Return to the shell, ignoring any further notesfiles in the 
current invocation. No sequencer information is updated. 

X Search for a note with the (prompted for) string in its title. 

Capital-X asks for a new search string, otherwise the last 
entered string is used. 

s Saves the currently displayed note/response at the end of a 

(prompted for) file. Capital-S saves the entire note string. 

M Sends the text of the note/response displayed and your com¬ 

ments to another user(s). The P command routes the letter to 
the author of the note/response. 

t Issues a write(l) command to the author of the currently 

displayed note/response. No action is taken if the note ori¬ 
ginated on a remote system or is anonymous. 

! Forks a shell. 

Nfpipe reads standard input to create a note in the specified notesfile. 
The title of the note is specified using the -t parameter. The -d flag 
specifies that this note is to have the director message flag enabled; if 
the author has no director privileges in the notesfile, this flag has no 
effect. Specifying -a makes the note anonymous; if anonymous notes are 
not permitted this flag has no effect. 

Nfprint gives the user the ability to print the contents of notesfiles. The 
-nn parameter specifies the page length to use (66 lines/page is the 
default). The note list is the set of notes which are to be printed. An 


space 


newline 

j 

J 

w 

q 
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example note list is; 1.30-36.13.10.42-50. Nfprint writes to standard out¬ 
put. 

Nfstals prints usage statistics for notesfiles. This program takes a list of 
notesfiles and lists their statistics on standard output. If more than one 
notesfile is specified, an aggregate set of statistics is also produced. 
Specify -s to have only this aggregate report printed and the individual 
reports suppressed. 

Checknotes reports on the existence of new notes. The NFSEQ environ¬ 
ment variable is read to determine the users subscription. Checknotes 
then looks at each of if there are new notes. The various flags specify 
the rnethod of notification. Use -q to have the message "There are new 
notes" printed if this is so. Specify -n to get a message "There are no 
new notes if this is the case. With the -v option enabled, checknotes 
prints the names of the notesfiles which have new notes in them. The -s 
option is silent; no output is produced. Regardless of the option, the pro¬ 
gram exits with 0 (TRUE) if new notes exist and with 1 (FALSE) if no new 
notes exist. 

An interface is provided to news(l). Transfers in both directions are sup¬ 
ported. See notes(8) for more information on how this works. 

Only the notesfile owner can create new notesfiles. The notesfile owner 
will create the notesfile and turn control over to the person requesting 
the notesfile. This person is the notesfile director: he may designate oth¬ 
ers to also be notesfile directors. The notesfile director has special 
privileges including: deleting any note, determining policy for the 
notesfile. permitting anonymous notes, and determining accessibility of 
the notesfile. 


The concept of a notesfile was taken from the PLATO system (a trade¬ 
mark of Control Data Corporation) designed at the University of Illinois 
to provide automated teaching capabilities. 

BUGS 

Only the name of a note’s originating system is kept; another utility must 
be used to generate paths for mailing to distant (more than 1 hop) 
authors. 

Some of the notesfile programs do not check to make sure the user is not 
the ANONUID user who is not allowed to run notes; the programs that fail 
to do this are ones which do not allow writing. 

Sometimes interrupting a display with the RUBOUT or DELETE key will 
leave the program in a state where it prints only the first character of 
titles and other headers. 

When more then 128 lines are saved with the "S" or "s" options of notes, 
the program reports strange values. This is because only 8 bits are avail¬ 
able for passing the result. 


FILES 

/etc/passwd 
/etc/group 
/ etc/termcap 
/usr/spool/notes 


for the users name 
for the users group 
for terminal capabilites 
the notesfile data base 
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/usr/spool/notes/.utilities utility programs and online help 
/usr/spool/notes/topic/text text of the notes in notesfile ‘topic’ 
/usr/spool/notes/topic/note.indx 

the note descriptors for notesfile ‘topic’ 
/usr/spool/notes/topic/resp.indx 

the response descriptors for notesfile 
‘topic’ 

/usr/spool/notes/topic/access the permission list for the notesfile 

‘topic’ 


SEE ALSO 

ed(l). news(l), nfcomment(3). notes(8), termcap(3). write(l). 
The Notesfile Reference Manual 

AUTHORS 

Ray Essick (uiucdcsiessick, uiucdcsinotes) 

Rob Kolstad (uiucdcsikolstad) 

Department of Computer Science 
222 Digital Computer Laboratory 
University of Illinois at Urbana-Champaign 
1304 West Springfield Ave. 

Urbana, IL 61801 
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NAME 

od - octal dump 


SYNOPSIS , , ,r 1 1 

od [ -bcdox ] [ file ] [ [ + ]offset[ . ][ b ] ] 

DESCRIPTION ■ , ^ ^ . 

Od dumps file in one or more formats as selected by the first argument. 

If the first argument is missing, —o is default. The meanings of the for¬ 
mat argument characters are: 


b Interpret bytes in octal. 

c Interpret bytes in ASCII. Certain non-graphic characters appear as C 
escapes: null=\0. backspace=\b. formfeed=\f, newline-\n. 

return=\ r, tab=\t; others appear as 3-digit octal numbers. 


d Interpret words in decimal, 
o Interpret words in octal. 


X Interpret words in hex. 

The file argument specifies which file is to be dumped. If no file argu¬ 
ment is specified, the standard input is used. 

The offset argument specifies the offset in the file where dumping is to 
commence. This argument is normally interpreted as octal bytes. If ‘.' is 
appended, the offset is interpreted in decimal. If ‘b' is appended, the 
offset is interpreted in blocks of 512 bytes. If the file argument is omit¬ 
ted. the offset argument must be preceded •+’. 

Dumping continues until end-of-file. 

SEE ALSO 

adb(l), xd(l) 
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NAME 

pack — packs or unpacks many files <—> one. 

SYNOPSIS 

a) pack filel [fileS] ... [filen] or 

b) pack 

DESCRIPTION 

a) pack filel ... filen 

packs these files onto stdout. Between the files the following line is 
inserted 

(/••••.. . . •••*•*/! 

b) pack 

unpacks stdin (a previously packed file) onto the component files. 

Hint: fgreppackedfile 

picks out the names of the component files). 

EXAMPLE I 

pack *.p I xref • 

makes a cross-reference list of a group of files. 

EXAMPLE2 

pack *.c I sed —f change.sed | pack 
seds a whole group of files at once. 

DIAGNOSTICS 

If file cannot be opened the message 
'cannot open file <file>' is written on stderr. 

If the inputfile has a bad format the message 

'phase error in line <line number>’ is written on stderr. 
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NAME 

passwd — change login password 
SYNOPSIS 

passwd [ name ] 

DESCRIPTION 

This command changes (or installs) a password associated with the user 
name (your own name by default). 

The program prompts for the old password and then for the new one. 
The caller must supply both. The new password must be typed twice, to 
forestall mistakes. 


FILES 


New passwords must be at least four characters long if they use a 
sufficiently rich alphabet and at least six characters long if monocase. 
These rules are relaxed if you are insistent enough. 

Only the owner of the name or the super-user may change a password; 
the owner must prove he knows the old password. 


/etc/passwd 
SEE ALSO 

login(l), passwd{5), crypt(3C) 

Robert Morris and Ken Thompson, Password Security: A Case History 
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NAME 

paste — merge same lines of several files or subsequent lines of one file 

SYNOPSIS 

paste file 1 fileS ... 
paste —dlist filel fileS ... 
paste —s [—dlist] filel fileS ... 

DESCRIPTION 

In the first two forms, paste concatenates corresponding lines of the 
given input files filel, fileS, etc. It treats each file as a column or 
columns of a table and pastes them together horizontally (parallel merg¬ 
ing). If you will, it is the counterpart of ca^(l) which concatenates verti¬ 
cally, i.e., one file after the other. In the last form above, pasfe subsumes 
the function of an older command with the same name by combining sub¬ 
sequent lines of the input file (serial merging). In all cases, lines are 
glued together with the tab character, or with characters from an 
optionally specified List. Output is to the standard output, so it can be 
used as the start of a pipe, or as a filter, if - is used in place of a file 
name. 

The meanings of the options are; 

-d Without this option, the new-line characters of each but the last 
file (or last line in case of the —s option) are replaced by a tab 
character. This option allows replacing the tab character by one 
or more alternate characters (see below). 

list One or more characters immediately following —d replace the 
default tab as the line concatenation character. The list is used 
circularly, i. e. when exhausted, it is reused. In parallel merging (i. 
e. no —s option), the lines from the last file are always terminated 
with a new-line character, not from the list. The list may contain 
the special escape sequences: \n (new-line), \t (tab), \\ 
(backslash), and \0 (empty string, not a null character). Quoting 
may be necessary, if characters have special meaning to the shell 
(e.g. to get one backslash, use -ol''\\\\''). 

-s Merge subsequent lines rather than one from each input file. Use 
tab for concatenation, unless a list is specified with —d option. 
Regardless of the list, the very last character of the file is forced 
to be a new-line. 

— May be used in place of any file name, to read a line from the stan¬ 
dard input. (There is no prompting). 

EXAMPLES 

Is I paste —d" '' — list directory in one column 

Is I paste —-— list directory in four columns 

paste —s —d"\ t\ n" file combine pairs of lines into lines 

SEE ALSO 

grep(l), cut(l), 

pr(l): pr -t -m.. . works similarly, but creates extra blanks, tabs and 
new-lines for a nice page layout. 
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DIAGNOSTICS 

Line too long 

too many files 


Output lines are restricted to 511 characters. 

Except for —s option, no more than 12 input files may 
be specified. 
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NAME 

pc — Pascal compiler 
SYNOPSIS 

pc [ option ] ... file ... 

DESCRIPTION 

pc is the MUNIX Pascal compiler. It accepts several types of arguments: 

Arguments whose names end with ’.p’ are taken to be Pascal source pro¬ 
grams; they are compiled, and each object program is left on a file with 
suffix ’.o’. The ’.o’ file is normally deleted, however, if a single Pascal pro¬ 
gram is compiled and loaded all at one go. Errors detected by the com¬ 
piler are listed on stdout. This Pascal compiler has the cpp-identifier 
mGSOOO predefined, i.e. "#ifdef mGBOOO" is true. 

Filenames are built from the basename of the source program and a cer¬ 
tain suffix. 

A call "pc test.p" is the same as "pc -c test.p && Id /lib/prtO.o test.o -Iffp 
-Ip -Ic icSc rm test.o". The call "pc *.o" is the same as "Id /lib/prtO.o *.o 
-Iffp -Ip -Ic". If your directory contains the file xyz.p, a call "make xyz" 
will result in "pc -o xyz xyz.p". 

The following options are interpreted by pc. See id(l) for load options. 

—c Suppress the loading phase of the compilation, and force an 

object file to be produced even if only one program is compiled. 

—d Switch on the debug mode. 

—e Display extension warning messages to stdout. 

—m Load new, meurk ic release instead of new ic dispose. 

—n Suppress execution ("dry run") of pc commands. 

—o output 

Name the final output file output. If this option is used the file 
’a.out’ will be left undisturbed. This option is passed on to the 
linker. 

—p Arrange for the compiler to produce code which counts the 

number of times each routine is called; also, if loading takes 
place, replace the standard startup routine by one which 
automatically calls monifor(3C) at the start and arranges to write 
out a mon.out file at normal termination of execution of the 
object program. An execution profile can then be generated by 
use of pro/(l). 

—t[l2] Find only the designated compiler passes in the files whose names 
are constructed by a —B option. In the absence of a —B option, 
. the string is taken to be ’/usr/src/cmd/pc/o’. 

—w Display warning messages to stdout. 

—Bstring 

Find substitute compiler passes in the files named string with the 
suffixes passl and pass2. If string is empty, use a standard 
backup version. 
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FILES 


—I>name=de/ 

—Dname 

Define the name to the preprocessor, as if by ’^define’. If no 
definition is given, the name is defined as 1. 

—Idir Files of ’#include' type whose names do not begin with ’/' are 
always sought first in the directory of the file argument, then in 
directories named in —I options, then in directories on a standard 
list. 

—L Additionally generates listings on corresponding files suffixed M’. 

—P Run only the macro preprocessor and place the result for each 

’.p’ file in a corresponding '.i' file and has no lines in it. 

—S Compile the named Pascal programs and leave the assembler- 
language output on corresponding files suffixed ’.s’. 

—T Trace and print pc commands. Temporary files are not deleted. 

—Uname 

Remove any initial definition of name. 

Other arguments are taken to be either loader(ld) option arguments, or 
Pascal-compatible object programs, typically produced by an earlier pc 
run, or perhaps libraries of Pascal-compatible routines. These programs, 
fogether with the results of any compilations specified, are loaded (in the 
order given) to produce an executable program with name a.out. 


file.i 

file.l 

file.o 

file.p 

file.s 

a.out 

/tmp/ptm* 

/lib/cpp 

/lib/pass[l2] 

/lib/c2 

/lib/perror 

./lib/prtO.o 

/lib/mprtO.o 

/lib/libmark.a 

/lib/libffp.a 

/lib/libp.a 

/lib/libc.a 

/usr/include/pc/init.h 

/usr/src/cmd/pc/opass[l2] 


preprocessor output file 
error and listing file 
object file 
input file 

assembler listing file 
loaded (linked) output 
temporary files for pc 
preprocessor 
compiler passes for pc 
compiler pass3 
prints errors and listing 
runtime startoff 
startoff for profiling 

pascal runtime-support (new, mark, release) 
library with floating point routines 
pascal runtime-support 
standard library, see intro (3) 
initialisation of Pascal compilation 
backup compiler passes for pc 
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SEE ALSO 

K. Jensen and N. Wirth Pascal User Manual and Report Sprincer Verlae 
1978 ^ K 6 e 

monitor(3C), prof(l), adb(l), ld(l) 

DIAGNOSTICS 

The diagnostics produced by pc itself are intended to be self- 
explanatory. Occasional messages may be produced by the loader(ld). 

BUGS 

None known. 
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NAME 

pg, pn - simple paginators for text files 

SYNOPSIS 

pg file 
pn file 

(any command) | pg 
DESCRIPTION 

pg and pn are very simple and small programs for displaying text files on 
a terminal. They can be called with one or more filenames or at the end 
of a pipe (for example 111 pg ). One cannot alter the files being displayed 
with pg 

The only difference between pg and pn is that pg erases the terminal 
screen before and after paginating the text whereas pn does not. 

pg displays files on a normal (24-line) terminal 23 lines at a time (wrap¬ 
ping lines longer that the screen width around) and waits after each, 
screenfull for the user to type in one of the command characters listed 
below. 

When displaying texts, the last line of the terminal is a prompt for user 
input. The prompt tells the user if there is more of the text file to come 
or if he is at the end. 


pg has commands to .look at different parts of a file. They are; 
Command Action 


f 

<RETURN> 


(Forwards) pg shows the next 23 lines of the file (if 
there are that many). 

same as f. 


<SPACE> same as f. 


same as f. 


d 

b 

q 


-c 


e 




(Down) pg scrolls the next 15 lines. 

(Back) pg goes back to line 1 of the file. This does not 
work with pipes. 

(Quit) switch to the next file (if there are more) or exit 
pg if not. 

exit pg 

(Edit) pg calls (with execlp) the user's environment 
editor (shell parameter EDITOR) on the text file being 
paginated. 

Display help file for vsh display mode and pg. 


pg is often better than cat because it automatically waits after each full 
terminal screen. Some people also prefer pg to more because one can go 
backwards in a file (ie. with 'b'). 
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BUGS 

pg has an internal function that tries to make sure that a file to be 
paginated is indeed ascii text. It sometimes gets confused and lets one 
look at a core dump or directory. The command ‘b’ is inoperable on 
pipes because one can’t rewind them... Otherwise pg has no known bugs. 

AUTHOR 

Stephen T. Pope at PCS GmbH, Munich. Germany 
SEE ALSO 

pg and pn are essentially the same as the internal paginator of ysh (1) 
and/or the help (1) utility. 
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NAME 

plot — graphics filters 


SYNOPSIS 

plot [ —Tterminal [ raster ] ] 
DESCRIPTION 


FILES 


These commands read plotting instructions {see plot(5)) from the stan¬ 
dard input, and in general produce plotting instructions suitable for a 
particular terminal on the standard output. 


If no terminal type is specified, the environment 
environ{7)) is used. Known terminals are: 


parameter STERM (see 


4014 Tektronix 4014 storage scope. 

450 DASI Hyterm 450 terminal (Diablo mechanism). 

300 DASI 300 or GSI terminal (Diablo mechanism). 

300S DASI 300S terminal (Diablo mechanism). 

ver Versatec D1200A printer-plotter. This version of plot places a 
scan-converted image in Vusr/tmp/raster’ and sends the result 
directly to the plotter device rather than to the standard output. 
The optional argument causes a previously scan-converted file 
raster to be sent to the plotter. 


Ibp Canon LBPlO laser beam printer, 

bip CADMUS bit map display. 


/usr/bin/tek 

/usr/bin/t450 

/usr/bin/t300 

/usr/bin/t300s 

/usr/bin/vplot 

/usr/tmp/raster 

/usr/bin/lplot 

/usr/bin/bplot 

SEE ALSO 

plot(3X), plot(5) 

BUGS 

There is no lockout protection for /usr/tmp/raster. 
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NAME 

postnews — submit news articles 
SYNOPSIS 

postnews [ article ] 

DESCRIPTION 

Postnews is a shell script that calls inews{l) to submit news articles to 
USENET. It should be edited to reflect your organizations name. It will 
prompt the user for the title of the article (which should be a phrase 
suggesting the subject, so that persons reading the news can tell if they 
are interested in the article) for the newsgroup, and for the distribution. 

An omitted newsgroup (from hitting return) will default to general. 

general is read by everyone on the local machine. Other possible news- 
groups include, but are not limited to, btl.general. which is read by all 
users at all Bell Labs sites on USENET, net.general, which is read by all 
users at all sites on USENET, and net.news, which is read by users 
interested in the network news on all sites. There is often a local set of 
newsgroups, such as ucb.all, that circulate within a local set of machines. 
(In this case, ucb newsgroups circulate among machines at the University 
of California at Berkeley.) 

The distribution can be any valid newsgroup name list, and defaults to 
the same as the newsgroup. (If they are the same, the distribution will be 
omitted from the headers put into the editor buffer.) A distribution 
header will, if given, be included in the headers of the article, affecting 
where the article is distributed to. 

After entering the title, newsgroup, and distribution, the user will be 
placed in an editor. If SEDITOR is set in the environment, that editor will 
be used. Otherwise, postnews defaults to 7neci(l). 

An initial set of headers containing the subject and newsgroups will be 
placed in the editor, followed by a blank line. The article should be 
appended to the buffer, after the blank line. These headers can be 
changed, or additional headers added, while in the editor, if desired. 

Optionally, the article will be read from the specifled filename. 

For more sophisticated uses, such as posting news from a program, see 
inews{l). 

FILES 
SEE ALSO 

checknews(l), inews(l), mail(l), readnews(l). 
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NAME 

pr — print files 
SYNOPSIS 

pr [ options ] [ files ] 

DESCRIPTION 

Pr prints the named files on the standard output. If file is —, or if no files 
are specified, the standard input is assumed. By default, the listing is 
separated into pages, each headed by the page number, a date and time, 
and the name of the file. 

By default, columns are of equal width, separated by at least one space; 
lines which do not fit are truncated. If the —s option is used, lines are not 
truncated and columns are separated by the separation character. 

If the standard output is associated with a terminal, error messages are 
withheld until pr has completed printing. 

Options may appear singly or be combined in any order. Their meanings 
are; 

+fc Begin printing with page k (default is 1). 

-k Produce fc-column output (default is 1). The options -e and -i are 
assumed for multi-column output. 

—a Print multi-column output across the page. 

m Merge and print all files simultaneously, one per column (overrides 
the —k, and —a options). 

—d Double-space the Output. 

—n Number the lines. 

—ecA: Expand input tabs to character positions fc-Hl, 2*Jb + l, 3*A: + 1, etc. 
If fc is 0 or is omitted, default tab settings at every eighth position 
are assumed. Tab characters in the input are expanded into the 
appropriate number of spaces. If c (any non-digit character) is 
given, it is treated as the input tab character (default for c is the 
tab character). 

—icA: In output, replace white space wherever possible by inserting tabs 
to character positions A; + l, 2*A:-H, 3*A: + 1, etc. If A: is 0 or is omit¬ 
ted, default tab settings at every eighth position are assumed. If c 
(any non-digit character) is given, it is treated as the output tab 
character (default for c is the tab character). 

—ncA: Provide Ar-digit line numbering (default for k is 5). The number 
occupies the first A: + l character positions of each column of nor¬ 
mal output or each line of —m output. If c (any non-digit charac¬ 
ter) is given, it is appended to the line number to separate it from 
whatever follows (default for c is a tab). 

—wA: Set the width of a line to k character positions (default is 72 for 

equal-width multi-column output, no limit otherwise). 

—oA: Offset each line by k character positions (default is 0). The 

number of character positions per line is the sum of the width and 
offset. 
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Ik Set the length of a page to k lines (default is 66). 

-h Use the next argument as the header to be printed instead of the 

file name. 

-p Pause before beginning each page if the output is directed to a 
terminal (pr will ring the bell at the terminal and wait for a car¬ 
riage return). 

-f Use form-feed character for new pages (default is to use a 
sequence of line-feeds). Pause before beginning the first page if 
the standard output is associated with a terminal. 

—r Print no diagnostic reports on failure to open files. 

-t Print neither the five-line identifying header nor the five-line 
trailer normally supplied for each page. Quit printing after the 
last line of each file without spacing to the end of the page. 

—sc Separate columns by the single character c instead of by the 
appropriate number of spaces (default for c is a tab). 

EXAMPLES 

® double-spaced, three-column listing headed by 
file list : * a j 

pr -3dh "file list" filel file2 

Write filel on file2. expanding tabs to columns 10, 19, 28, 37, ... : 
pr -e9 -t <filel >file2 

FILES 

/dev/tty* to suspend messages 

SEE ALSO 

cat(l). 
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NAME 

prep prepare text for statistical processing 
SYNOPSIS 

prep [ -dio ] file ... 

DESCRIPTION 

reads each in sequence and writes it on the standard output 

a string of alphabetic characters Ind 
mbedded apostrophes, delimited by space or punctuation. Hyphenated 

hvnS' apart; hyphens at the end of lines are removed and the 

hyphenated parts are joined. Strings of digits are discarded. 

The following option letters may appear in any order; 

-d Print the word number (in the input stream) with each word. 

'ignore' file. These words will not appear 
in the output. (They will be counted, for purposes of the -d 

OLinJ 

Take the next as an 'only' file. Only these words will appear in 

the output. (All other words will also be counted for the -d 
count.; 

Include punctuation marks (single nonalphanumeric characters) 
as separate output lines. The punctuation marks are not counted 
for the —d count. 

Ignore and only files contain words, one per line. 

SEE ALSO 

derofr(l) 


—o 


-P 
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NAME 

prmail - print out mail in the post office 
SYNOPSIS 

prmail [ user ... ] 

DESCRIPTION 

Prmail prints the mail which waits for you, or the specified user, in the 
post office. The mail is not disturbed. 

FILES 

/usr/mail/* post office 
SEE ALSO 

mail(l), from(l) 
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NAME 

prof — display profile data 
SYNOPSIS 

prof [ -V ] [ -a ] [ -1 ] [ -Low [ -high ] ] [ file ] 

DESCRIPTION 

Prof interprets the file mon.out produced by the monitor subroutine. 
Under default modes, the symbol table in the named object file (a.out 
default) is read and correlated with the mon.out profile file. For each 
external symbol, the percentage of time spent executing between that 
symbol and the next is printed (in decreasing order), together with the 
number of times that routine was called and the number of milliseconds 
per call. 

If the —a option is used, all symbols are reported rather than just exter¬ 
nal symbols. If the -1 option is used, the output is listed by symbol value 
rather than decreasing percentage. 

If the -V option is used, all printing is suppressed and a graphic version 
of the profile is produced on the standard output for display by the 
j)fof(lG) filters. The numbers low and high, by default 0 and 100. cause a 
selected percentage of . the profile to be plotted with accordingly higher 
resolution. 

In order for the number of calls to a routine to be tallied, the —p option 
of cc must have been given when the file containing the routine was com¬ 
piled. This option also arranges for the mon.out file to be produced 
automatically. 

FILES 

mon.out for profile 
a.out for namelist 

SEE ALSO 

monitor(3C). profil(2). cc(l). plot(lG) 

BUGS 

Beware of quantization errors. 
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NAME 

prs — print an SCCS file 
SYNOPSIS 

prs [-d[dataspec]] [-r[SID]] [-e] [-1] [-a] files 
DESCRIPTION 

Prs prints, on the standard output, parts or all of an SCCS file (see 
sccsfile{5)) in a user supplied format. If a directory is named, prs 
behaves as though each file in the directory were specified as a named 
file, except that non-SCCS files (last component of the path name does 
not begin with s.), and unreadable files are silently ignored. If a name of 
— is given, the standard input is read; each line of the standard input is 
taken to be the name of an SCCS file or directory to be processed; non- 
^ SCCS files and unreadable files are silently ignored. 

Arguments to prs, which may appear in any order, consist of keyLetter 
arguments, and file names. 

All the described keyletter arguments apply independently to each 
named file; 

-d[da<aspec] Used to specify the output data specification. The 
dataspec is a string consisting of SCCS file data key¬ 
words (see DATA KEYWORDS) interspersed with optional 
user supplied text. 

-r[S;D] Used to specify the SCCS /Dentification (SID) string of 

a delta for which information is desired. If no SID is 
specified, the SID of the most recently created delta is 
assumed. 

“G Requests information for all deltas created earlier 

than and including the delta designated via the —r 
keyletter. 

Requests information for all deltas created later than 
and including the delta designated via the —r 
keyletter. 

—a Requests printing of information for both removed, 

i.e., delta type = R, (see rmdel{l)) and existing, i.e., 
delta type = D, deltas. If the —a keyletter is not 
specified, information for existing deltas only is pro¬ 
vided. 

DATA KEYWORDS 

Data keywords specify which parts of an SCCS file are to be retrieved and 
output. All parts of an SCCS file (see sccsfile{5)) have an associated data 
keyword. There is no limit on the number of times a data keyword may 
appear in a dataspec. 

The information printed by prs consists of: (1) the user supplied text; 
and (2) appropriate values (extracted from the SCCS file) substituted for 
the recognized data keywords in the order of appearance in the 
dataspec. The format of a data keyword value is either Simple (S), in 
which keyword substitution is direct, or Multi-line (M), in which keyword 
substitution is followed by a carriage return. 
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User supplied text is any text other than recognized data keywords. A 
tab is specified by \t and carriage return/new-line is specified by \n. 
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Keyword 

:Dl: 

:DL: 

:Li: 

:Ld: 

:Lu: 

:DT: 

:I: 

:R: 

:L: 

:B: 

:S: 

:D: 

:Dy: 

:Dm: 

:Dd: 

:T: 

:Th: 

:Tm: 

:Ts: 

:P: 

:DS: 

:DP: 

:DI: 

:Dn: 

;Dx: 

:Dg: 

:MR: 

:C: 

:UN: 

:FL: 

:Y: 

:MF: 

:MP: 

:KF: 

:BF: 

:J: 

:LK: 

:Q: 

:M: 

:FB: 

:CB: 

:Ds: 

:ND: 

:FD: 

:BD: 

:GB: 

:W: 

:A: 

:Z: 

:F: 

:PN: 


TABLE 1. sees Files Data Keywords 


Data Item. 

Delta information 
Delta line statistics 
Lines inserted by Delta 
Lines deleted by Delta 
Lines unchanged by Delta 
Delta type 
sees ID string (SID) 

Release number 

Level number 

Branch number 

Sequence number 

Date Delta created 

Year Delta created 

Month Delta created 

Day Delta created 

Time Delta created 

Hour Delta created 

Minutes Delta created 

Seconds Delta created 

Programmer who created Delta 

Delta sequence number 

Predecessor Delta seq-no. 

Seq-no. of deltas incL, excL, ignored 
Deltas included (seq #) 

Deltas excluded (seq #) 

Deltas ignored (seq #) 

MR numbers for delta 
Comments for delta 
User names 
Flag list 

Module type flag 

MR validation flag 

MR validation pgm name 

Keyword error/warning flag 

Branch flag 

Joint edit flag 

Locked releases 

User defined keyword 

Module name 

Floor boundary 

Ceiling boundary 

Default SID 

Null delta flag 

File descriptive text 

Body 

Gotten body 

A form of what{\) string 
A form of wh.at(l) string 
what{l) string delimiter 
sees flle name 
secs flle path name 


File Section 
Delta Table 


User Names 
Flags 

i* 


Comments 

Body 

tr 

N/A 

N/A 

N/A 

N/A 

N/A 


:Dt: = :DT: :I: :D: :T: :P: :DS: :DP: 


VaLae Format 

See below* S 

:Li:/:Ld:/:Lu: S 

nnnnn S 

nnnnn S 

nnnnn S 

D or R S 

:R:.:L:.:B:.:S: S 

nnnn S 

nnnn S 

nnnn S 

nnnn S 

:Dy:/:Dm:/:Dd: S 

nn S 

nn S 

nn S 

:Th:::Tm:::Ts: S 

nn S 

nn S 

nn S 

logname S 

nnnn S 

nnnn S 

:Dn:/:Dx:/:Dg: S 

:DS: :DS:... S 

:DS: :DS:... S 

:DS: :DS:... S 

text M 

text M 

text M 

text M 

text S 

yes or no S 

text S 

yes or no S 

yes or no S 

yes or no S 

:R:... S 

text S 

text S 

:R: S 

:R: S 

:I: S 

yes or no S 

text M 

text M 

text M 

:Z::M:\t:I: S 

:Z::Y: :M: :I::Z: S 

@(#) S 

text S 

text S 
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EXAMPLES 


prs -d'’Users and/or user IDs for :F: are:\n:UN;" 
may produce on the standard output; 

Users and/or user IDs for s.file are: 


xyz 

131 

abc 


s.file 


prs d''Newest delta for pgm :M:; :I: Created :D: By :P:'’ -r s.file 
may produce on the standard output; 

Newest delta for pgm main.c: 3.7 Created 77/12/1 By cas 
As a special case; 

prs s.file 


may produce on the standard output; 

D 1.1 77/12/1 00:00:00 cas 1 000000/00000/00000 
MRs: 


FILES 


5170-12345 
5179-54321 
COMMENTS: 

this is the comment line for s.file initial delta 


for each delta table entry of the "D” type. The only keyletter argument 
allowed to be used with the special case is the —a keyletter. 

/tmp/pr????? 


SEE ALSO 

admin(l). delta(l). get(l). help(l). sccsfile(5). 

Source Code Control System User’s Guide by L. E. Bonanni and C. A. 


DIAGNOSTICS 

Use help{i) for explanations. 
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NAME 

ps — process status 
SYNOPSIS 

ps [ alx ] [ namelist ] 

DESCRIPTION 

ft prints certain indicia about active processes. The a option asks for 
information about all processes with terminals (ordinarily only one's own 
processes are displayed); x asks even about processes with no terminal; 1 
asks for a long listing. The short listing contains the process ID, tty 
letter, the cumulative execution time of the process and an approxima¬ 
tion to the command line. 

The long listing is columnar and contains 

Flags associated with the process. 01: in core; 02: system process; 
04; locked in core (e.g. for physical I/O); 10: being swapped; 20; 
being traced by another process. 

The state of the process. 0; nonexistent; S: sleeping: W: waiting; R: 
running; I; intermediate; Z: terminated; T: stopped. 

The user ID of the process owner. 

The process ID of the process; as in certain cults it is possible to 
kill a process if you know its true name. 

The process ID of the parent process. 

Processor utilization for scheduling. 

The priority of the process; high numbers mean low priority. 

Used in priority computation. 

The core address of the process if resident, otherwise the disk 
address. 

The size in units of Ik of the core image of the process. 

WCHAN 

The event for which the process is waiting or sleeping: if blank, the 
process is running. 

TTY The controlling tty for the process. 

TIME The cumulative execution time for the process. 

The command and its arguments. 

A process that has exited and has a parent, but has not yet been waited 
for by the parent is marked <defunct>. ft makes an educated guess as 
to the file name and arguments given when the process was created by 
examining core memory or the swap area. The method is inherently 
somewhat unreliable and in any event a process is entitled to destroy 
this information, so the names cannot be counted on too much. 

If a second argument is given, it is taken to be the file containing the 
system's namelist, otherwise, /unix is assumed. 

FILES 

/Unix system namelist 


F 

S 

LTD 

PID 

PPID 

CPU 

PRI 

NICE 

ADDR 

SZ 
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/dev/mem core memory 
/dev/kmem alternate core file 

/dev searched to find swap device and tty names 

SEE ALSO 

kill(l) 

bugs . . , , 

Things can change while ps is running; the picture it gives is only a close 
approximation to reality. 

Some data printed for defunct processes is irrelevant 
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NAME 

pti — phototypesetter interpreter 

SYNOPSIS 

pti [ file ... ] 

DESCRIPTION 

Pti shows the commands in a stream from the standard output of troff{\) 
using troff's —t option, interpreting them as they would act on the 
typesetter. Horizontal motions shows as counts in internal units and are 
marked with ’<' and '>’ indicating left and right motion. Vertical space is 
called lead and is also indicated. 

SEE ALSO 

trofT(l) 

BUGS 

Too cryptic for normal users, who should use "troff —a ...”. 
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NAME 

ptx — permuted index 
SYNOPSIS 

ptx [ option ] ... [ input [ output ] ] 

DESCRIPTION 

Ptx generates a permuted index to file input on file output (standard 
input and output default). It has three phases; the first does the permu¬ 
tation, generating one line for each keyword in an input line. The key¬ 
word is rotated to the front. The permuted file is then sorted. Finally, 
the sorted lines are rotated so the keyword comes at the middle of the 
page. Ptx produces output in the form: 

.XX "tail'' "before keyword" "keyword and after" "head" 

where .xx may be an nrojf or troff{l) macro for user-defined formatting. 
The before keyword and keyword and after fields incorporate as much of 
the line as will fit around the keyword when it is printed at the middle of 
the page. Tail and head, at least one of which is an empty string "", are 
wrapped-around pieces small enough to fit in the unused space at the 
opposite end of the line. When original text must be discarded, V marks 
the spot. 

The following options can be applied: 

—f Fold upper and lower case letters for sorting. 

-t Prepare the output for the phototypesetter; the default line 
length is 100 characters. 

—wn Use the next argument, n, as the width of the output line. The 
default line length is 72 characters. 

-g n Use the next argument, n. as the number of characters to allow 
for each gap among the four parts of the line as finally printed. 
The default gap is 3 characters. 

—o only 

Use as keywords only the words given in the only file. 

—i ignore 

Do not use as keywords any words given in the ignore file. If the -i 
and -0 options are missing, use /usr/lib/eign as the ignore file. 

—b break 

Use the characters in the break file to separate words. In any 
case, tab, newline, and space characters are always used as break 
characters. 

—r Take any leading nonblank characters of each input line to be a 

reference identifier (as to a page or chapter) separate from the 
text of the line. Attach that identifier as a 5th field on each out¬ 
put line. 

The index for this manual was generated using ptx. 

FILES 

/bin/sort 

/usr/lib/eign 
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EXAMPLE 

The following is a reasonably-minimal set of nroff statements which will 
format ptx output reasonably; the style is similar to the index for this 
manual. The spacings may need adjustment for different output devices. 

.de XX 

.if !''''\ \ S1 '■ \ \ 81 \ fl\ a\ fR\ \ S2\ t\ \ S3\ fI\ a\ fR\ t\ \ 85 
.if !""\ \ 84" \ t\ \ 82\ t\ \ 83\ fl\ a\ fR\ \ 84\ t\ \ 85 
.if ""\\81\\84" \t\\82\t\\83\fI\a\fR\t\\85 

.nf 

.ta 3.7iR 3.95iL 7.65iR 7.8iR 

BUGS 

Line length counts do not account for overstriking or proportional spac¬ 
ing. 
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NAME 

pwd — working directory name 

SYNOPSIS 

pwd 

DESCRIPTION 

Pwd prints the pathname of the working (current) directory. 

SEE ALSO 

cd(l) 
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NAME 

ranlib — convert archives to random libraries 

SYNOPSIS 

ranlib archive ... 

DESCRIPTION 

Ranlib converts each archive to a form which can be loaded more rapidly 

by the loader, by adding a table of contents named _.SYMDEF to the 

beginning of the archive. It uses ar(l) to reconstruct the archive, so 
that sufficient temporary file space must be available in the file system 
containing the current directory. 

SEE ALSO 

ld(l).ar(l) 

BUGS 

Because generation of a library by ar and randomization by ranlib are 
separate, phase errors are possible. The loader Id warns when the 
modification date of a library is more recent than the creation of its dic¬ 
tionary; but this means you get the warning even if you only copy the 
library. 
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NAME 

ratfor — rational Fortran dialect 
SYNOPSIS 

ratfor [ options ] [ files ] 

DESCRIPTION 

Ratfor converts a rational dialect of Fortran into ordinary irrational For¬ 
tran. Ratfor provides control flow constructs essentially identical to 
those in C; 

statement grouping: 

j statement; statement; statement j 

decision-making: 

if (condition) statement [ else statement ] 
switch (integer value) { 

case integer: statement 

[ default: ] statement 

I 

loops: 

while (condition) statement 

for (expression; condition; expression) statement 

do limits statement 

repeat statement [ until (condition) ] 

break 

next 

and some syntactic sugar to make programs easier to read and write; 
free form input: 

multiple statements/line; automatic continuation 

comments: 

# this is a comment. 

translation of relationals: 

>, >=, etc., become .GT., .GE., etc. 

return expression to caller from function; 
return (expression) 

define; 

define name replacement 

include: 

include file 

The option — h causes quoted strings to be turned into 27H constructs. 
The —C option copies comments to the output and attempts to format it 
neatly. Normally, continuation lines are marked with a & in column 1; 
the option — 6x makes the continuation character x and places it in 
column 6. 

Ratfor is best used with f77{\). 

SEE ALSO 

efl(l). f77(l). 

B. W. Kernighan and P. J. Plauger, Software Tools, Addison-Wesley, 1976. 
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NAME 

readnews — read news articles 


SYNOPSIS 

readnews [ -a date ] [ -n newsgroups ] [ -l titles ] [ —IprxhfuM ] [ 
—c [ mailer ] ] 

readnews —s 

DESCRIPTION 

readnews without argument prints unread articles. There are several 
interfaces available; 

Flag Interface 

default A msgs{l) like interface. 

—M An interface to il/aiZ(l). 



—c 


—c 


A /6m/maiZ(l)—like interface. 
"mailer " 


All selected articles written to a temporary file. Then the mailer 
is invoked. The name of the temporary file is referenced with a 
Thus, "mail —f %” will invoke mail on a temporary file con¬ 
sisting of all selected messages. 

—p All selected articles are sent to the standard output. No ques¬ 

tions asked. 


—1 Only the titles output. The .newsrc file will not be updated. 

The —r flag causes the articles to be printed in reverse order. The —f flag 
prevents any followup articles from being printed. The —h flag causes 
articles to be printed in a less verbose format, and is intended for termi¬ 
nals running at 300 baud, the —u flag causes the .newsrc file to be 
updated every 5 minutes, in case of an unreliable system. (Note that if 
the newsrc file is updated, the x command will not restore it to its origi¬ 
nal contents.) 

The following flags determine the selection of articles. 

—n newsgroups 

Select all articles that belong to newsgroups. 

—t titles Select all articles whose titles contain one of the 
specified by titles. 

—a [ date ] 

Select all articles that were posted past the given date 
date(3) format). 

-X Ignore .newsrc file. That is, select articles that have 

been read as well as new ones. 


strings 

(in get- 
already 


readnews maintains a .neti;src file in the user’s home directory that 
specifies all news articles already read. It is updated at the end of each 
reading session in which the —x or —1 options weren’t specified. If the 
environment variable NEWSRC is present, it should be the path name of a 
file to be used in place of .newsrc. 

If the user wishes, an options line may be placed in the .newsrc file. This 
line starts with the word options (left justified) followed by the list of 
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standard options just as they would be typed on the command line. Such 
a list may include: the -n flag along with a newsgroup list; a favorite 
interface; and/or the -r or -t flag. Continuation lines are specified by 
following lines beginning with a space or tab character. Similarly, 
options can be specified in the NEWSOPTS environment parameter. 
Where conflicts exist, option on the command line take precedence, fol¬ 
lowed by the .newsrc options line, and lastly the NEWSOPTS parameter. 

readnews —s will print the newsgroup subscription list. 

When the user uses the reply command of the msgs{l) or /bin/maiL{l) 
interfaces, the environment parameter MAILER will be used to determine 
which mailer to use. The default is usually /bin/mail. 

If the user so desires, he may specify a specific paging progam for arti¬ 
cles. The environment parameter PAGER should be set to the paging pro¬ 
gram. The name of the article is referenced with a as in the —c 
option. If no •%’ is present, the article will be piped to the program. Pag¬ 
ing may be disabled by setting PAGER to a null value. 

COMMANDS 

This section lists the commands you can type to the msgs and /bin/mail 
interface prompts. The msgs interface will suggest some common com¬ 
mands in brackets. Just hitting return is the same as typing the first 
command. For example, "[ynq]” means that the commands ”y'' (yes), 
"n" (no), and ''q” (quit) are common responses, and that “y” is the 
default. Command Meaning 

y Yes. Prints current article and goes on to next. 

n No. Goes on to next article without printing current one. In the 
/bin/mail interface, this means “go on to the next article", which 
will have the same effect as "y” or just hitting return. 

q Quit. The .newsrc file will be updated if -1 or -x were not on the 
command line. 

c Cancel the article. Only the author or the super user can do this. 

r Reply. Reply to article’s author via mail. You are placed in your 

EDITOR with a header specifying To, Subject, and References lines 
taken from the message. You may change or add headers, as 
appropriate. You add the text of the reply after the blank line, 
and then exit the editor. The resulting message is mailed to the 
author of the article. 

rd Reply directly. You are placed in SMAILER ("mail" by default) in 
reply to the author. Type the text of the reply and then control-Z. 

f [fifie] 

Submit a follow up article. Normally you should leave off the title, 
since the system will generate one for you. You will be placed in 
your EDITOR to compose the text of the followup. 

fd Followup directly, without edited headers. This is like /, but the 
headers of the article are not included in the editor buffer. 

N [newsgroup'\ 

Go to the next newsgroup or named newsgroup. 
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s [/iZe] 

Save. The article is appended to the named file. The default is 
Articles . If the first character of the file name is the rest of 
the file name is taken as the name of a program, which is executed 
with the text of the article as standard input. If the first charac* 
ter of the file name is / , it is taken as a full path name of a file. If 
SNEWSBOX (in the environment) is set to a full path name, and the 
file contains no / , the file is saved in SNEWSBOX. Otherwise, it is 
saved relative to SHOME. 

Report the name and size of the newsgroup. 

Erase. Forget that this article was read. 

Print a more verbose header. 

Print a very verbose header, containing all known information 
about the article. 

Unsubscribe from this newsgroup. Also goes on to the next news- 
group. 

Read a digest. Breaks up a digest into separate articles and per¬ 
mits you to read and reply to each piece. 

Decrypt. 'Invokes a Caesar decoding program on the body of the 
message. This is used to decrypt rotated jokes posted to net.jokes. 
Such jokes are usually obscene or otherwise offensive to some 
groups of people, and so are rotated to avoid accidental decryp¬ 
tion by people who would be offended. The title of the joke should 
indicate the nature of the problem, enabling people to decide 
whether to decrypt it or not. 

Normally the Caesar program does a character frequency count on each 
line of the article separately, so that lines which are not rotated will be 
shown in plain text. Thisiworks well unless the line is short, in which case 
it sometimes gets the wrong rotation. An explicit number rotation (usu¬ 
ally 13) may be given to force a particular shift. 

V Print the current version of the news software. 

! Shell escape. 

number 

Go to number. 

-h[n] Skip n articles. The articles skipped are recorded as "unread" 
and will be offered to you again the next time you read news. 

— Go back to last article. This is a toggle, typing it twice returns you 
to the original article. 

x Exit. Like quit except that .newsrc is not updated. 

X system 

Transmit article to the named system. 

The commands c, f, fd, r, rd, e, h, H, and s can be followed by -’s to refer 
to the previous article. Thus, when replying to an article using the msgs 
interface, you should normally type "r—” (or "re-") since by the time you 
enter a command, you are being offerred the next article. 


# 

e 

h 

H 

U 

d 
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EXAMPLES 

readnews 

Read all unread articles using the msgs(l) interface. The 
.newsrc file is updated at the end of the session. 

readnews —c ”ed X” —1 

Invoke the ed(l) text editor on a file containing the titles of all 
unread articles. The .newsrc file is not updated at the end of 
the session. 

readnews —n all ifa.all —M —r 

Read all unread articles except articles whose newsgroups begin 
with "fa.'' via Afaii(l) in reverse order. The .newsrc file is 
updated at the end of the session. 

readnews —p —n all —a last thursday 

Print every unread article since last Thursday. The .newsrc file 
is updated at the end of the session. 

readnews —p > /dev/nuU Sc 

Discard all unread news. This is useful after returning from a 
long trip. 

/usr/spool/news/netiisflrroup/number 

News articles 

/usr/lib/news/active Active newsgroups and numbers of articles 
/usr/lib/news/help Help file for ms^s(l) interface 
--/.newsrc Options and list of previously read articles 

SEE ALSO ^ ^ ^ . 

checknews(l). inews(l). sendnews(8). recnews(8). uurec(8), msgs(l). 
Mail(l). mail(l). news(5). newsrc(5) 

AUTHORS 

Matt Glickman 
Mark Horton 
Stephen Daniel 
Tom R. Truscott 


FILES 
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NAME 

recnews — receive unprocessed articles via mail 
SYNOPSIS 

recnews [ newsgroup [ sender ] ] 

DESCRIPTION 

recnews reads a letter from the standard input; determines the article 
title, sender, and newsgroup; and gives the body to inews with the rieht 
arguments for insertion. ® 

If newsgroup is omitted, the to line of the letter will be used. If sender is 
omitted, the sender will be determined from the from line of the letter 
The title is determined from the subject line. 

SEE ALSO 

inews(l), uurec(8), sendnews(8), readnews(l), checknews(l) 
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NAME 

refer, lookbib — find and insert literature references in documents 

SYNOPSIS 

refer [ option ] ... 

lookbib [ file ] ... 

DESCRIPTION 

Lookbib accepts keywords from the standard input and searches a biblio¬ 
graphic data base for references that contain those keywords anywhere 
in title, author, journal name, etc. Matching references are printed on 
the standard output. Blank lines are taken as delimiters between 
queries. 

Refer is a preprocessor for nroff or trojf{\) that finds and formats refer¬ 
ences. The input files (standard input default) are copied to the stan¬ 
dard output, except for lines between .[ and .] command lines, which are 
assumed to contain keywords as for lookbib, and are replaced by infor¬ 
mation from the bibliographic data base. The user may avoid the search, 
override fields from it, or add new fields. The reference data, from what¬ 
ever source, are assigned to a set of troff strings. Macro packages such 
as ms (7) print the finished reference text from these strings. A flag is 
placed in the text at the point of reference; by default the references are 
indicated by numbers. 

The following options are available: 

—ar Reverse the first r author names (Jones, J. A. instead of J. A. Jones). 
If r is omitted all author names are reversed. 

—b Bare mode; do not put any flags in text (neither numbers nor 

labels). 

—cstring 

Capitalize (with CAPS SMALL CAPS) the fields whose key-letters are in 
string. 

—e Instead of leaving the references where encountered, accumulate 

them until a sequence of the form 
•[ 

SLISTS 

.] 

is encountered, and then write out all references collected so far. 
Collapse references to the same source. 

—kx Instead of numbering references, use labels as specified in a refer¬ 
ence data line beginning Zx; by default x is L. 

—lm,n 

Instead of numbering references, use labels made from the senior 
author’s last name and the year of publication. Only the first m 
letters of the last name and the last n digits of the date are used. 
If either m or ,n is omitted the entire name or date respectively is 
used. 

—p Take the next argument as a file of references to be searched. The 

default file is searched last. 
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-n Do not search the default file. 

references by flelds whose key-letlers ere In the icv^string^ 
permute reference numbers in text accordingly. Implies ^ Ih 
key-letters in keys may be followed by a number to indi 
manv such fields are used, with -h taken as a very large number. 
The Lfault is AD which sorts on the senior author and then date, to 
sort, for example, on all authors and then title use -sA+T. 

To use your own references, put them in the format 

dei(l) They can be searched more rapidly by running pu6index(l) on 
them before using refer; failure to index results in a linear search. 

When refer is used with egn. negn or tbL, refer should be first, to minimize 
the volume of data passed through pipes. 

/usr/diet/papers directory of default publication lists and indexes 
/usr/Lib/refer directory of programs 

SEE ALSO 
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NAME 

reform - reformat text file 
SYNOPSIS 

f+tnT° [tabspec2j] [+bn] [+en] [+f] [+in] [+mn] [+pn] [+s] 

DESCRIPTION 

Reform reads each line of the standard input file, reformats it. and then 
writes it to the standard output. Various combinations of reformatting 
operations can be selected, of which the most common involve rear¬ 
rangement of tab characters. It is often used to trim trailing blanks, 
truncate lines to a specified length, or prepend blanks to lines. 

Reform first scans its arguments, which may be given in any order. It 
then processes its input file, performing the following actions upon each 
line, in the order given: 

— A line is read from the standard input. 

- If +s is given, all characters up to the first tab are stripped off and 
saved for later addition to the end of the line. Presumably, these 
characters comprise an "SCCS SID" produced by ye<(l). 

— The line is expanded into a tabless form, by replacing tabs with blanks 
according to the input tab specification tabspecl. 

- If +pn is given, n blanks are prepended to the line. 

— If +tn is given, the line is truncated to a length of n characters. 

— All trailing blanks are now removed. 

— If +en is included, the line is extended out with blanks to the length of 
n characters. 

- If +s is given, the previously-saved "SCCS SID" is added to the end of 
the line. 

- If +bn is given, the n characters at the beginning of the line are con¬ 
verted to blanks, if and only if all of them are either digits or blanks. 

~ If +ni7i is included, the line is moved left, i.e., n characters are 
removed from the beginning of the line. 

- The line is now contracted by replacing some blanks with tab charac¬ 
ters according to the list of tabs indicated by the output tab 
specification tabspecS, and is written to the standard output file. 
Option +i controls the method of contraction (see below). 

The various arguments accepted by reform are as follows; 
tabspecl 

describes the tab stops assumed for the input file. This tab 
specification may take on any of the forms described in <a6s(l). 
In addition, the operand — indicates that the tab specification 
is to be found in the first line read from the standard input. If 
no legal tab specification is found there, —8 is assumed. If 
tabspecl is omitted entirely, — is assumed. 

tabspecS 

describes the tabs assumed for the output file. It is 
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interpreted in the same way as tabspecl, except that omission 
of tabspec2 causes the value of tabspecl to be used for 
tabspec2. 

The remaining arguments are all optional and may be used in any com¬ 
bination, although only a few combinations make much sense. Specify¬ 
ing an argument causes an action to be performed, as opposed to the 
usual default of not performing the action. Some options include 
numeric values, which also have default values. Option actions are 
applied to each line in the order described above. Any line length men¬ 
tioned applies to the length of a line just before the execution of the 
option described, and the terminating new-line is never counted in the 
line length. 

-fbn causes the first n characters of a line to be converted to 
blanks, if and only if those characters include only blanks and 
digits. If n is omitted, the default value is 6, which is useful in 
deleting sequence numbers from COBOL programs. 

+en causes each line shorter than n characters to be extended out 
with blanks to that length. Omitting n implies a default value 
of 72. This option is useful for those rare cases in which 
sequence numbers need to be added to an existing unnum¬ 
bered file. The use of S in editor regular expressions is more 
convenient if all lines have equal length, so that the user can 
issue editor commands such as; 
s/SOOOOlOOO/ 

-hf causes a format line to be written to the standard output, 

preceding any other lines written. See fspec(5) for details 
regarding format specifications. The format line is taken from 
tabspec2, i.e., the line normally appears as follows; 

<:\.—tabspec2 d:> 

If tabspec2 is of the form — file-name (i.e., an indirect reference to a 

tab specification in the first line of the named file), then that tab 

specification line is written to the standard output. 

-tin controls the technique used to compress interior blanks into 
. tabs. Unless this option is specified, any sequence of 1 or more 
blanks may be converted to a single tab character if that 
sequence occurs just before a tab stop. This causes no prob¬ 
lems for blanks that occur before the first nonblank character 
in a line, and it is always possible to convert the result back to 
an equivalent tabless form. However, occasionally an interior 
blank (one occurring after the first nonblank) is converted to 
a tab when this is not intended. For instance, this might occur 
in any program written in a language utilizing blanks as delim¬ 
iters. Any single blank might be converted to a tab if it 
occurred just before a tab stop. Insertion or deletion of char¬ 
acters preceding such a tab may cause it to be interpreted in 
an unexpected way at a later time. If the -H option is used, no 
string of blanks may be converted to a tab unless there are n 
or more contiguous blanks. The default value is 2. Note that 
leading blanks are always converted to tabs when possible. It 
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is recommended that conversion of programs from non -UNIX 
to UNIX systems use this option. 

causes each line to be moved lift n characters, with a default 
value of 6. This can be useful for crunching COBOL programs. 

causes n blanks to be prepended (default of 6 if n is omitted). 
This option is effectively the inverse of +mn, and is often useful 
for adjusting the position of nroj7(i) output for terminals lack¬ 
ing both forms tractor positioning and a settable left margin. 

is used with the —m option of The —m option causes gBt 

to prepend to each generated line the appropriate SCCS SID. 
followed by a tab. The +s option causes reform to remove the 
SID from the front of the line, save it. then add it later to the 
end of the line. Because +e72 is implied by this option, the 
effect is to produce 80-character card images with SCCS SID in 
columns 73-80. Up to 8 characters of the SID are shown; if it is 
longer, the eighth character is replaced by • and any charac¬ 
ters to the right of it are discarded. 

causes any line longer than n characters to be truncated to 
that length. If n is omitted, the length defaults to 72. 
Sequence numbers can thus be removed and any blanks 
immediately preceding them deleted. 

The following illustrate typical uses of reform. The terms PWB and 
OBJECT below refer to UND( and non- UNIX computer systems, respec¬ 
tively. Each arrow indicates the direction of conversion. The character 
? indicates an arbitrary tab specification; see fabs(l) for descriptions of 
legal specifications. 

OBJECT-> PWB (i.e., manipulation of RJE output): ' 

Note that files transferred by RJE from OBJECT to PWB materialize with 
format —8. 

reform -8 -c +t +b +i <oldfile >newfile (into COBOL) 

reform -8 -c3 +t +m +i <oldfile >newfile (into COBOL crunched) 

NOTE: -c3 is the preferred format COBOL: it uses the least disk space of the 
COBOL formats. 

^ OBJECT (i.e., preparation of files for RJE submission): 

reform ? —8 <oldfile >newfile (from arbitrary format into —8) 
get —p —m sccsfile | reform +s | send ... 

PWB ONLY (i.e., no involvement with other systems): 

pr file I reform ? —0 <oldfile (print on terminal without hardware tabs) 
reform ? —0 <oldfile >newfile (convert file to tabless format) 

DIAGNOSTICS 

All diagnostics are fatal, and the offending line is displayed following the 
message. 

line too long” a line exceeds 512 characters (in tabless form), 
not SCCS m a line does not have at least-one tab when +s fiag is used. 
Any of the diagnostics of fabs(l) can also appear. 


REFORM(1) 

+mn. 

+p7l 

+S 


+tn 
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EXIT CODES 


0 — normal 
1 — any error 


SEE ALSO 


get(l). nrofT(l). send(lC), tabs(l), fspec(5). 


BUGS 


Reform is aware of the meanings of backspaces and escape sequences, so 
that it can be used as a postprocessor for nroff. However, be warned 
that the +e, +m, and +l options only count characters, not positions. 
Anyone using these options on output containing backspaces or halfline 
motions will probably obtain unexpected results. 
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NAME 

regcmp — regular expression compile 

SYNOPSIS 

regcmp [ — ] files 

DESCRIPTION 

Regcmp, in most cases, precludes the need for calling regcmp (see 
regex(3X)) from C programs. This saves on both execution time and pro¬ 
gram size. The command regcmp compiles the regular expressions in file 
and places the output in file.i. If the — option is used, the output will be 
placed in file.c. The format of entries in file is a name (C variable) fol¬ 
lowed by one or more blanks followed by a regular expression enclosed in 
double quotes. The output of regcmp is C source code. Compiled regular 
expressions are represented as extern char vectors. PiLe.i files may thus 
be included into C programs, or file.c files may be compiled and later 
loaded. In the C program which uses the regcmp output, regex{abc,line) 
will apply the regular expression named abc to line. Diagnostics are 
self-explanatory. 

EXAMPLES 

name "([A—Za—z][A—Za—zO—9_]*)S0'' 

telno "\(i0,li([2-9][0l][l-9])S0\)(0,lj •" 

''([2-9][0-9](2j)Sl[-](0,lj'’ 

”([0-9]j4i)S2" 

In the C program that uses the regcmp output, 
regex(telno, line, area, exch, rest) 
will apply the regular expression named telno to line. 

SEE ALSO 

regex(3X). 
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NAME 

rev — reverse lines of a file 

SYNOPSIS 

rev [ file ] ... 

DESCRIPTION 

Rev copies the named files to the standard output, reversing the order of 
characters in every line. If no file is specified, the standard input is 
copied. 
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NAME 

rjestat — RJE status report and interactive status console 
SYNOPSIS 

rjestat [ host ]... [ —shost ] [ —chost cmd ]... 

DESCRIPTION 

I^estat provides a method of determining the status of an RJE link and of 
simulating an IBM remote console (with UNIX features added). When 
invoked with no arguments, rjestat reports the current status of all the 
RJE links connected to to the UNIX system. The options are: 

host Print the status of the line to host. Host is the pseudonym 

for a particular IBM system. It can be any name that 
corresponds to one in the first column of the RJE 
configuration file. 

—shost After all the arguments have been processed, start an 
interactive status console to host. 

—chost cmd Interpret cmd as if it were entered in status console mode to 
host. See below for the proper format of cmd. 

In status console mode, rjestat prompts with the host pseudonym fol¬ 
lowed by : whenever it is ready to accept a command. Commands are ter¬ 
minated with a new-line. A line that begins with ! is sent to the UNIX shell 
for execution. A line that begins with the letter q terminates rjestat. All 
other input lines are assumed to have the form; 

ibmcmd [ redirect ] 

Ibmcmd is any IBM JES or HASP command. Only the super-user or rje 
login can send commands other than display or inquiry commands. 
Redirect is a pipeline or a redirection to a file (e.g., "> file” or “ | grep 
..."). The IBM response is written to the pipeline or file. If redirect is not 
present, the response is written to the standard output of rjestat. 

An interrupt signal (DEL or BREAK) will cancel the command in progress 
and cause rjestat to return to the command input mode. 

EXAMPLE 

The following command reports the status of all the card readers 
attached to host A. remote 5. JES2 is assumed. 

rjestat —cA 'Sdu.rmtS | grep RD' 

DIAGNOSTICS 

The message "RJE error: ..." indicates that rjestat found an inconsistency 
in the RJE system. This may be transient but should be reported to the 
site administrator. 


FILES 

/usr/rje/lines RJE configuration file 

resp host response file that exists in the RJE subsystem direc 

tory (e.g.. /usr/rjel). 

SEE ALSO 

send(lC), rje(8). 

0S/VS2 HASP II Version 4 Operator’s Guide, IBM SRL #GC27-6993. 
Operator's Library: OS/VS2 Reference (JES2), IBM SRL #0038-0210. 
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NAUE 

rni, rrndir ”• remove files or directories 
SYNOPSIS 

rm [ —fri ] file ... 

rmdir dir ... 

DESCRIPTION 

Rm removes the entries for one or more files from a directory. If an 
entry was the last link to the file, the file is destroyed. Removal of a file 
requires write permission in its directory, but neither read nor write per* 
mission on the file itself. 


If a file has no write permission and the standard input is a terminal, its 
permissions are printed and a line is read from the standard input. If 
that line begins with y the file is deleted, otherwise theJile remains. No 
questions are asked when the —f option is given or if the standard input 
is not a terminal. 


If a designated file is a directory, an error comment is printed unless the 
optional argument —r has been used. In that case, rm recursively 
deletes the entire contents of the specified directory, and the directory 


If the -i (interactive) option is in effect, rm asks whether to delete each 
file, and, under —r, whether to examine each directory. 

Rmdir removes entries for the named directories, which must be empty. 
SEE ALSO 


unlink(2). 


DIAGNOSTICS 

Generally self-explanatory. It is forbidden to remove the file .. merely to 
avoid the antisocial consequences of inadvertently doing something like: 

rm—r .• 
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NAME 

rmdel — remove a delta from an SCCS file 

SYNOPSIS 

rmdel —rSID files 

DESCRIPTION 

Rmdel removes the delta specified by the SID from each named SCCS file. 
The delta to be removed must be the newest (most recent) delta in its 
branch in the delta chain of each named SCCS file. In addition, the 
specified must not be that of a version being edited for the purpose of 
making a delta (i. e., if a^p-flle (see ^ef(l)) exists for the named SCCS file, 
the specified must nof appear in any entry of the p-file). 

If a directory is named, rmdel behaves as though each file in the direc¬ 
tory were specified as a named file.jexcept that non-SCCS files (last com¬ 
ponent of the path name does not begin with s.) and unreadable files are 
silently ignored. If a name of — is given, the standard input is read; each 
line of the standard input is taken to be the name of an SCCS file to be 
processed; non-SCCS files and unreadable files are silently ignored. 

The exact permissions necessary to remove a delta are documented in 
the Source Code Control System User’s Guide. Simply stated, they are 
either (1) if you make a delta you can remove it; or (2) if you own the file 
and directory you can remove a delta. 

FILES 

x-file (see delta{l)) 

2 -file (see deifa(l)) 

SEE ALSO 

delta(l), get(l), help(l), prs(l). sccsfile(5). 

Source Code Control System User’s Guide by L. E. Bonanni and C. A. 
Salemi. 

DIAGNOSTICS 

Use help{l) for explanations. 
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NAME 

rxctrl - floppy disk manipulating program 
SYNOPSIS 

rxctrl — [ fsdiz ] /dev/rrx? 

DESCRIPTION 

Rxctrl is used to give commands to the floppy drive: 

f Format data fields according to specified floppy density. This does 
not replace rxformat (see/ormaf(0)). which must be used to format 
new floppies. 

s Byte swapping on. 

d restore default setting: no byte swap, interleave of sectors on. first 
fill upper, then lower floppy side. 

Unusual commands: 

1 Interleave of sectors off. 

2 Zigzag on: sequential blocks on different floppy sides. 

FILES 

/dev/rrx* 

SEE ALSO 

rx(4), format(8) 

< 

I 
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NAME 

sact — print current SCCS file editing activity 

SYNOPSIS 

sact files 

DESCRIPTION 

Sact informs the user of any impending deltas to a named SCCS file. This 
situation occurs when get{l) with the -e option has been previously exe¬ 
cuted without a subsequent execution of deLta{l). If a directory is 
named on the command line, sact behaves as though each file in the 
directory were specified as a named file, except that non-SCCS files and 
unreadable files are silently ignored. If a name of — is given, the stan¬ 
dard input is read with each line being taken as the name of an SCCS file 
to be processed. 

The output for each named file consists of five fields separated by spaces. 

Field 1 specifies the SID of a delta that currently exists in the 
SCCS file to which changes will be made to make the new 
delta. 

Field 2 specifies the SID for the new delta to be created. 

Field 3 contains the logname of the user who will make the delta 

(i.e. executed a get for editing). 

Field 4 contains the date that get —e was executed. 

Field 5 contains the time that get -e was executed. 

SEE ALSO 

delta(l), get(l), unget(l). 

DIAGNOSTICS 

Use help{l) for explanations. 
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NAME 

sag — system activity graph 

SYNOPSIS 

sag [ options ] 

DESCRIPTION 

Sag graphically displays the system activity data stored in a binary data 
file by a previous sar(l) run. Any of the sar data items may be plotted 
singly, or in combination; as cross plots, or versus time. Simple arith¬ 
metic combinations of data may be specified. Sag invokes sar and finds 
the desired data by string-matching the data column header (run sar to 
see what’s available). These options are passed thru to sar: 

—s time Select data later than time in the form hh[:mm]. Default is 
08:00. 

—e time Select data up to fime. Default is 18:00. 

—i sec Select data at intervals as close as possible to sec seconds. 

—f file Use file as the data source for sar. Default is the current daily 
data file /visr/adm/sa/sadd. 

Other options: 

—T term 

Produce output suitable for terminal term. See fpZof(lG) for 
known terminals. Default for term is STERU. 

—X spec 

X axis specification with spec in the form; 

"name [op name].,..[lo hi]" 

—y spec 

y axis specification with spec in the same form as above. 

Name is either a string that will match a column header in the sar 
report, with an optional device name in square brackets, e.g., 
r+w/s[dsk—1], or an integer value. Op is + — • or / surrounded by 
blanks. Up to five names may be specified. Parentheses are not recog¬ 
nized. Contrary to custom, + and — have precedence over • and /. 
Evaluation is left to right. Thus A / A + B • 100 is evaluated 
(A/(A+B))*100, and A + B/ C + Dis (A+B)/(C+D). Lo and hi are 
optional numeric scale limits. If unspecified, they are deduced from the 
data. 

A single spec is permitted for the x axis. If unspecified, time is used. Up 
to 5 spec's separated by ; may be given for —y. Enclose the —x and —y 
arguments in if blanks or \ <CR> are included. The —y default is: 

—y "%usr 0 100; %usr + %sys 0 100; %usr + %sys + Xwio 0 100" 
EXAMPLES 

To see today's CPU utilization: 
sag 

To see activity over 15 minutes of all disk drives: 

TS='date 

sar —o tempfile 60 15 
TE='date +%H:%M' 
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sag -f tempfile -s STS -e STE -y "r+w/s[dsk]'' 

FILES 

/usr/adm/sa/sacici daily data file for day dd. 

SEE ALSO 

sar(l). tplot(lG). 


February 17, 1984 


Page 2 









SAR(l) 


MUNIX 


SAR(l) 


NAME 

sar — system activity reporter 
SYNOPSIS 

sar [—ubdycwaqvmA] [-o file] t [ n ] 

sar [-UbdycwaqvmA] [-3 time] [-e time] [-i sec] [-f file] 
DESCRIPTION 

Sar, in the first instance, samples cumulative activity counters in the 
operating system at n intervals of t seconds. If the —o option is specified, 
it saves the samples in file in binary format. The default value of n is l! 
In the second instance, with no sampling interval specified, sar extracts 
data from a previously recorded file, either the one specified by -f option 
or, by default, the standard system activity daily data file 
/usT/adm/sa/sadd for the current day dd. The starting and ending 
times of the report can be bounded via the —s and —e time arguments of 
the form AA[:mm[:ss]]. The —i option selects records at sec second inter¬ 
vals. Otherwise, all intervals found in the data file are reported. 

In either case, subsets of data to be printed are specified by option; 

—u Report CPU utilization (the default): 

JSusr, /5sys, JSwio, %idle — portion of time running in user mode, run¬ 
ning in system mode, idle with some process waiting for block I/O, 
and otherwise idle. 

—b Report buffer activity; 

bread/s, bwrit/s — transfers per second of data between system 
buffers and disk or other block devices; 

Iread/s, Iwrit/s — accesses of system buffers; 

%rcache, %wcache — cache hit ratios, e. g., 1 — bread/Iread; 
pread/s, pwrit/s - transfers via raw (physical) device mechanism. 

—d Report activity for each block device, e. g.. disk or tape drive: 

%busy, avque — portion of time device was busy servicing a transfer 
request, average number of requests outstanding during that time; 
r+w/s, blks/s — number of data transfers from or to device, number 
of bytes transferred in 512 byte units; 

avwait, avserv — average time in ms. that transfer requests wait idly 
on queue, and average time to be serviced (which for disks includes 
seek, rotational latency and data transfer times). 

—y Report TTY device activity: 

rawch/s, canch/s, outch/s — input character rate, input character 

rate processed by canon, output character rate; 

rcvin/s, xmtin/s, mdmin/s — receive, transmit and modem interrupt 

rates. 

—c Report system calls: 

scall/s — system calls of all types; 

sread/s, swrit/s, fork/s, exec/s — specific system calls; 

rchar/s, wchar/s — characters transferred by read and write system 

calls. 

—w Report system swapping and switching activity: 

swpin/s, swpot/s, bswin/s, bswot/s — number of transfers and 
number of 512 byte units transferred for swapins (including initial 
loading of some programs) and swapouts; 
pswch/s — process switches. 
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-a Report use of file access system routines; 

iget/s, namei/s. dirblk/s. , • j. 

—q Report average queue length while occupied, and % of time occupied: 
runq-sz, %runocc - run queue of processes in memory and runnable; 
swpq-sz. %swpocc - swap queue of processes swapped out but ready 

to run. 

-V Report status of text, process, inode and file tables: 

text-sz, proc-sz. inod-sz. file-sz - entries/size for each table, 
evaluated once at sampling point; 

j_gj(t-ov, proc*ov, inod'ov, file*ov — overflows occurring between sam 
pling points. 

—m Report message and semaphore activities; 

msg/s, sema/s - primitives per second. 

-A Report all data. Equivalent to -udqbwcayvm. 

EXAMPLES 

To see today’s CPU activity so far: 
sar 

To watch CPU activity evolve for 10 minutes and save data: 
sar —o temp 60 10 

To later review disk and tape activity from that period; 
sar —d —f temp 


FILES 


/usr/adm/sa/sadd daily data file, where dd are digits representing the 
day of the month. 


SEE ALSO 

sag(lG). sar(8). 
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NAME' 

sccsdiff - compare two versions of an SCCS file 
SYNOPSIS 

sccsdifT —rSIDl —rSID2 [—p] [~sn] files 
DESCRIPTION 

Sccsdiff compares two versions of an SCCS file and generates the. 
differences between the two versions. Any number of SCCS files may be 
specified, but arguments apply to all files. 

—tSIIP SIDl and SIDS specify the deltas of an SCCS file that are 
to be compared. Versions are passed to bdiff{l) in the 
order given. 

-p pipe output for each file through pr(l). 

-sn n is the file segment size that bdiff will pass to diff{l). 

This is useful when diff fails due to a high system load. 

FILES 

/tmp/get????? Temporary files 
SEE ALSO 

bdifT(l). get(l). help(l). pr(l). 

Source Code Control System User's Cuidehy L. E. Bonanni and C. A. 
Salemi. 

DIAGNOSTICS 

"file: No differences" If the two versions are the same. 

Use h.elp{l) for explanations. 
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NAME 

script — make typescript of terminal session 
SYNOPSIS 

script [ —a ] [ file ] 

DESCRIPTION 

Script makes a typescript of everything printed on your terminal. The 
typescript is written to file, or appended to file if the —a option is given. 
It can be sent to the line printer later with Ipr. If no file name is given, 
the typescript is saved in the file typescript. 

The script ends when the forked shell exits. 

This program is useful when using a crt and a hard-copy record of the 
dialog is desired, as for a student handing in a program that was 
developed on a crt when hard-copy terminals are in short supply. 

BUGS 

Script places everything in the log file. This is not what the naive user 
expects. 
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NAME 

sdifT — side-by-side difference program 
SYNOPSIS 

sdiff [ options ... ] filel file2 
DESCRIPTION 

Sdiff uses the output of diff(l) to produce a side-by-side listing of two 
files indicating those lines that are different. Each line of the two files is 
printed with a blank gutter between them if the lines are identical, a < in 
the gutter if the line only exists in filel, a > in the gutter if the line only 
exists in fileS, and a | for lines that are different. 

For example; 

X I y 

a a 

b < 

c < 

d d 

> c 

The following options exist: 

—w n Use the next argument, n, as the width of the output line. The 
default line length is 130 characters. 

—1 Only print the left side of any lines that are identical. 

—s Do not print identical lines. 

—o output 

Use the next argument, output, as the name of a third file that 
is created as a user controlled merging of filel and fileS. 
Identical lines of filel and fileS are copied to output. Sets of 
differences, as produced by diff{l), are printed; where a set of 
differences share a common gutter character. After printing 
each set of differences, sdiff prompts the user with a % and 
waits for one of the following user-typed commands: 

1 append the left column to the output file 
r append the right column to the output file 

s turn on silent mode; do not print identical lines 

V turn off silent mode 

e 1 call the editor with the left column 

e r call the editor with the right column 

e b call the editor with the concatenation of left and 
right 

e call the editor with a zero length file 
q exit from the program 

On exit from the editor, the resulting file is concatenated on 
the end of the output file. 
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SEE ALSO 

difr(l). ed(l). 
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NAME 

sed — stream editor 
SYNOPSIS 

sed [ -n ] [ -e script ] [ -f sfile ] [ files ] 

DESCRIPTION 

Sed copies the named files (standard input default) to the standard out¬ 
put. edited according to a script of commands. The -f option causes the 
script to be taken from file sfile; these options accumulate. If there is 
just one —e option and no —f options, the flag —e may be omitted. The —n 
option suppresses the default output. A script consists of editing com¬ 
mands, one per line, of the following form: 

[ address [ , address ] ] function [ arguments ] 

In normal operation, sed cyclically copies a line of input into a pattern 
space (unless there is something left after a D command), applies in 
sequence all commands whose addresses select that pattern space, and 
at the end of the script copies the pattern space to the standard output 
(except under —n) and deletes the pattern space. 

Some of the commands use a hold space to save all or part of the pattern 
space for subsequent retrieval. 

An address is either a decimal number that counts input lines cumula¬ 
tively across files, a S that addresses the last line of input, or a context 
address, i.e., a /regular expression/ in the style of ed(l) modified thus; 

In a context address, the construction \?regular expression?. 
where ? is any character, is identical to /regular expres¬ 
sion/. Note that in the context address \xabc\xdefx. the 
second x stands for itself, so that the regular expression is 
abcxdef. 

The escape sequence \n matches a new-line embedded in the pat¬ 
tern space. 

A period . matches any character except the terminal new-line of 
the pattern space. 

A command line with no addresses selects every pattern space. 

A command line with one address selects each pattern space that 
matches the address. 

A command line with two addresses selects the inclusive range 
from the first pattern space that matches the first address 
through the next pattern space that matches the second. 
(If the second address is a number less than or equal to the 
line number first selected, only one line is selected.) 
Thereafter the process is repeated, looking again for the 
first address. 

Editing commands can be applied only to non-selected pattern spaces by 
use of the negation function ! (below). 

following list of functions the maximum number of permissible 
addresses for each function is indicated in parentheses. 

The text argument consists of one or more lines, all but the last of which 
end with \ to hide the new-line. Backslashes in text are treated like 
backslashes in the replacement string of an s command, and may be used 
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to protect initial blanks and tabs against the stripping that is done on 
every script line. The rfiLe or wfile argument must terminate the com¬ 
mand line and must be preceded by exactly one blank. Each wfile is 
created before processing begins. There can be at most 10 distinct wfile 
arguments. 

(1) a\ 

text Append. Place text on the output before reading the next input 
line. 

{2)h label 

Branch to the : command bearing the label. If label is empty, 
branch to the end of the script. 

(2) c\ 

text Change. Delete the pattern space. With 0 or 1 address or at the 
end of a 2-address range, place text on the output. Start the 
next cycle. 

(2) d Delete the pattern space. Start the next cycle. 

(2)D Delete the initial segment of the pattern space through the first 

new-line. Start the next cycle. 

(2) g Replace the contents of the pattern space by the contents of 
the hold space. 

(2) G Append the contents of the hold space to the pattern space. 

(2) h Replace the contents of the hold space by the contents of the 
pattern space. 

(2) H Append the contents of the pattern space to the hold space. 

(1) i\ 

text Insert. Place text on the standard output. 

(2) 1 List the pattern space on the standard output in an unambigu¬ 

ous form. Non-printing characters are spelled in two-digit ASCII 
and long lines are folded. 

(2) n Copy the pattern space to the standard output. Replace the 
pattern space with the next line of input. 

(2) N Append the next line of input to the pattern space with an 
embedded new-line. (The current line number changes.) 

(2) p Print. Copy the pattern space to the standard output. 

(2) P Copy the initial segment of the pattern space through the first 

new-line to the standard output. 

(1) q Quit. Branch to the end of the script. Do not start a new cycle. 

(2) r rfile 

Read the contents of rfile. Place them on the output before 
reading the next input line. 

(2) s/regular expression /replacement/flags 

Substitute the replacement string for instances of the regular 
expression in the pattern space. Any character may be used 
instead of /. For a fuller description see ed(l). Flags is zero or 
more of: 

g Global. Substitute for all nonoverlapping 
instances of the regular expression rather than 
just the first one. 

p Print the pattern space if a replacement was 
made. 


February 17, 1984 


Page 2 









SED(l) 


MUNIX 


SED(l) 


w wfile 

Write. Append the pattern space to wfile if a 
replacement was made. 

(2) t label 

Test. Branch to the r command bearing the label if any substi¬ 
tutions have been made since the most recent reading of an 
input line or execution of a t. If label is empty, branch to the 
end of the script. 

(2) w wfile 

Write. Append the pattern space to wfile. 

(2) X Exchange the contents of the pattern and hold spaces. 

(2) y/string 1 /strings/ 

Transform. Replace all occurrences of characters in stringi 
with the corresponding character in strings. The lengths of 
string 1 and strings must be equal. 

{Z)\ function 

Don't. Apply the function (or group, if function is () only to 
lines not selected by the address(es). 

(0 );label 

This command does nothing; it bears a label for b and t com¬ 
mands to branch to. 

~ Place the current line number on the standard output as a line. 
(2) j Execute the following commands through a matching J only 
when the pattern space is selected. 

(0) An empty command is ignored. 

SEE ALSO 

awk(l), ed(l), grep(l). 
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NAME 

send - gather files and submit RJE jobs 
SYNOPSIS 

send argument ... 

DESCRIPTION 

Send is a command-level interface to the RJE subsystems. It allows the 
user to collect input from various sources in order to create a run 
stream consisting of card images, and submit this run stream for 
transmission to a host computer. 

Possible sources of input to send are; ordinary files, standard input, the 
terminal, and the output of a command or shell file. Each source of 
input is treated as a virtual file, and no distinction is made based upon 
its origin. Typical input is an ASCII text file of the sort that is created by 
the editor ed(l). An optional format specification appearing in the first 
line of a file (see /spec(5)) determines the settings according to which 
tabs are expanded into spaces. In addition, lines that begin with ~ are 
normally interpreted as commands controlling the execution of send. 
They may be used to set or reset flags, to define keyword substitutions, 
and to open new sources of input in the midst of the current source. 
Other text lines are translated one-for-one into card images of the run 
stream. 

The run stream that results from this collection is treated as one job by 
the RJE subsystems. Send prints the card count of the run stream, and 
the queuer that is invoked prints the name of the temporary file that 
holds the job while it is. awaiting transmission. The initial card of a job 
submitted to an IBM host must have a // in the first column. The initial 
card of a job submitted to a UNIVAC host must begin with a “©RUN” or 
■•'run", etc. Any cards preceding these will be excised. If a host com¬ 
puter is not specified before the first card of the runstream is ready to 
be sent, send will select a reasonable default. In the case of an IBM job. 
all cards beginning with /♦$ will be excised from the runstream. because 
they are HASP command cards. 

The arguments that send accepts are described below. An argument is 
interpreted according to the first pattern that it matches. Preceding a 
character with \ causes it to loose any special meaning it might other¬ 
wise have when matching against an argument pattern. 


• 

Close the current source. 

— 

Open standard input as a new source. 

+ 

Open the terminal as a new source. 

:spec: 

Establish a default format specification for included 

sources, 

e.g., :m6t—12: 

imessage 

Print message on the terminal. 

'-iprompt 

Open standard input and, if it is a terminal, print 
prompt. 

prompt 

Open the terminal and prinX, prompt. 
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-flags 

-f/iags 

-flags 

Set the specifled flags, which are described below. 
Reset the specifled flags. 

Restore the specifled flags to their state at the pre¬ 
vious level. 

Icommand 

Execute the specifled UND( command via the one- 
line shell, with input redirected to /dev/nuU as a 
default. Open the standard output of the command 
as a new source. 

Sline 

Collect contiguous arguments of this form and write 
them as consecutive lines to a temporary file; then 
have the file executed by the shell. Open the stan¬ 
dard output of the shell as a new source. 

(^directory 

The current directory for the send process is 
changed to direcfoTT/. The original directory will be 
restored at the end of the current source. 

•^comment 

?:keyword 

Ignore this argument. 

Prompt for a definition of keyword from the termi¬ 
nal unless keyword has an existing definition. 

?keyword—xx 

Define the keyword as a two digit hexadecimal char¬ 
acter code unless it already has a non null replace¬ 
ment. 

^keyword-string 

Define the keyword in terms of a replacement string 
unless it already has a non null replacement. 

—•.keyword 

Prompt for a definition of keyword from the termi¬ 
nal. 

keyword—XX 

Define keyword as a two-digit hexadecimal charac¬ 
ter code. 

keyword—string 

host 

Define keyword in terms of a replacement string. 

The host machine that the job should be submitted 
to. It can be any name that corresponds to one in 
the first column of the RJE configuration file 
(/ usr /rje /lines). 

file-name 

Open the specifled file as a new source of input. 


When comniands are executed via S or ! the shell environment (see 
environ{7)) will contain the values of all send keywords that begin with 
S and have the syntax of a shell variable. 

The flags recognized by send are described in terms of the special pro¬ 
cessing that occurs when they are set: 

-1 List card images on standard output. EBCDIC characters are 
translated back to ASCII. 

—q Do not output card images. 

—f Do not fold lower case to upper. 

—t Trace progress on diagnostic output, by announcing the opening 
of input sources. 
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k Ignore the keywords that are active at the previous level and 
erase any keyword definitions that have been made at the 
current level. 

-r Process included sources in raw mode; pack arbitrary 8-bit bytes 
one per column (80 columns per card) until an EOF. 

—i Do not interpret control lines in included sources; treat them as 
text. 

—s Make keyword substitutions before detecting and interpreting 
control lines. 

y Suppress error diagnostics and submit job anyway. 

-g Gather mode, qualifying -1 flag; list text lines before converting 
them to card images. 

—h Write listing with standard tabs. 

P Prompt with ♦ when taking input from the terminal. 

~m When input returns to the terminal from a lower level, repeat the 
prompt, if any. 

—a Make —k flag propagate to included sources, thereby protecting 
them from keyword substitutions. 

c List control lines on diagnostic output. 

-d Extend the current set of keyword definitions by adding those 
active at the end of included sources. 

X This flag guarantees that the job will be transmitted in the order 
of submission (relative to other jobs sent with this flag). 

Control lines are input lines that begin with ~. In the default mode 
+ir. they are interpreted as commands to send. Normally they are 
detected immediately and read literally. The -s flag forces keyword 
substitutions to be made before control lines are intercepted and 
interpreted. This can lead to unexpected results if a control line 
uses a keyword which is defined within an immediately preceding ~8 
sequence. Arguments appearing in control lines are handled exactly 
like the command arguments to send, except that they are processed 
at a nested level of input. 

pe two possible formats for a control line are; ••~argument" and 
argumentIn the first case, where the ~ is not followed by a 
space, the remainder of the line is taken as a single argument to 
send. In the second case, the line is parsed to obtain a sequence of 
arguments delimited by spaces. In this case the quotes * and " may 
be employed to pass embedded spaces. 

The interpretation of the argument is chosen so that an input line 
consisting of is treated as a logical EOF. The following example 
illustrates some of the above conventions: 

send — 

~ argument ... 
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This sequence of three lines is equivalent to the command synopsis at 
the beginning of this description. In fact, the — is not even required. 
By convention, the send command reads standard input if no other 
input source is specified. Send may therefore be employed as a filter 
with side-effects. 

The execution of the send command is controlled at each instant by 
a current environment, which includes the format specification for 
the input source, a default format specification for included sources, 
the settings of the mode flags, and the active set of keyword 
definitions. This environment can be altered dynamically. When a 
control line opens a new source of input, the current environment is 
pushed onto a stack, to be restored when input resumes from the old 
source. The initial format specification for the new source is taken 
from the first line of the file. If none is provided, the established 
default is used or, in its absence, standard tabs. The initial mode set¬ 
tings and active keywords are copied from the old environment. 
Changes made while processing the new source will not affect the 
environment of the old source, with one exception: if —d mode is set 
in the old environment, the old keyword context will be augmented by 
those definitions that-are active at the end of the new source. 

When send first begins execution, all mode flags are reset, and the 
values of the shell environment variables become the initial values 
for keywords of the same name with a S prefixed. 

The initial reset state for all mode flags is the + state. In general, 
special processing associated with a mode N is invoked by flag —N and 
is revoked by flag +//. Most mode settings have an immediate effect 
on the processing of the current source. Exceptions to this are the 
—r and —i flags, which apply only to included source, causing it to be 
processed in an uninterpreted manner. 

A keyword is an arbitrary 8-bit ASCII string for which a replacement 
has been defined. The replacement may be another string, or (for IBM 
RJE only) the hexadecimal code for a single 8-bit byte. At any 
instant, a given set of keyword definitions is active. Input text lines 
are scanned, in one pass from left to right, and longest matches are 
attempted between substrings of the line and the active set of key¬ 
words. Characters that do not match are output, subject to folding 
and the standard translation. Keywords are replaced by the specified 
hexadecimal code or replacement string, which is then output char¬ 
acter by character. The expansion of tabs and length checking, 
according to the format specification of an input source, are delayed 
until substitutions have been made in a line. 

All of the keywords definitions made in the current source may be 
deleted by setting the —k flag. It then becomes possible to reuse 
them. Setting the —k flag also causes keyword definitions active at 
the previous source level to be ignored. Setting the +k flag causes 
keywords at the previous level to be ignored but does not delete the 
definitions made at the current level. The =k argument reactivates 
the definitions of the previous level. 
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When keywords are redefined, the previous definition at the same 
level of source input is lost, however the definition at the previous 
level is only hidden, to be reactivated upon return to that level unless 
a —d fiag causes the current definition to be retained. 

Conditional prompts for keywords. ?:A./p which have already been 
defined at some higher level to be null or have a replacement will sim¬ 
ply cause the definitions to be copied down to the current level; new 
definitions will not be solicited. 

Keyword substitution is an elementary macro facility that is easily 
explained and that appears useful enough to warrant its inclusion in 
the send command. More complex replacements are the function of 
a general macro processor perhaps). To reduce the overhead 

of string comparison, it is recommended that keywords be chosen so 
that their initial characters are unusual. For example, let them all 
be upper case. 

Send performs two types of error checking on input text lines. 
Firstly, only ASCII, graphics and tabs are permitted in input text. 
Secondly, the length of a text line, after substitutions have been 
made, may not exceed 80 bytes for IBM. or 132 bytes for UNIVAC. The 
length of each line may be additionally constrained by a size parame¬ 
ter in the format specification for an input source. Diagnostic output 
provides the location of each erroneous line, by line number and 
input source, a description of the error, and the card image that 
results. Other routine errors that are announced are the inability to 
open or write files, and abnormal exits from the shell. Normally, the 
occurrence of any error causes send, before invoking the queuer, to 
prompt for positive affirmation that the suspect run stream should be 
submitted. 

For IBM hosts, send is required to translate 8-bit ASCII characters into 
their EBCDIC equivalents. The conversion for 8-bit ASCII characters in 
the octal range 040-176 is based on the character set described in 
"Appendix H" of IBM System/370 Principles of Operation (IBM SRL 
GA22-7000). Each 8-bit ASCII character in the range 040-377 
possesses an EBCDIC equivalent into which it is mapped, with five 
exceptions; ~ into -, 0345 into 0325 into ♦, 0313 into |. 0177 (DEL) 
is illegal. In listings requested from send and in printed output 
returned by the subsystem, the reverse translation is made with the 
qualification that EBCDIC characters that do not have valid 8-bit ASCII 
equivalents are translated into UNIVAC hosts, on the other hand, 
operate in ASCII code, and any translations between ASCII and field- 
data are made, in accordance with the UNIVAC standard, by the host 
computer. 

Additional control over the translation process is afforded by the —f 
flag and hexadecimal character codes. As a default, send folds 
lower-case letters into upper case. For UNIVAC RJE it does more; the 
entire ASCII range 0140-0176 is folded into 0100-0136, so that for 
example, becomes @. In either case, setting the —f flag inhibits any 
folding. Non-standard character codes are obtained as a special case 
of keyword substitution. 
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SEE ALSO . . 

m4(l). rjestat(lC), sh(l), fspec(5). ascu(7). rje(8). ^ ^ ^ , 

Guide to IBM Remote Job Entry for PWB/UNIX Users by A. L. Sabsevitz and 
E. J. Finger. 

UNIX Remote Job Entry User’s Guide by K. A. Kelleman. 


Standard input is read in blocks, and unused bytes are returned via 
Lseek(2). If standard input is a pipe, multiple arguments of the form 
and —'.prompt should not be used, nor should the logical EOF (~.)- 
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NAME 

sh, rsh — shell, the standard/restricted command programming language 
SYNOPSIS 

sh [ —ceiknrsluvx ] [ args ] 
rsh [ —ceiknrstuvx ] [ args ] 

DESCRIPTION 

Sh is a command programming language that executes commands read 
from a terminal or a file. Rsh is a restricted version of the standard 
command interpreter sh-, it is used to set up login names and execution 
environments whose capabilities are more controlled than those of the 
standard shell. See Invocation below for the meaning of arguments to 
the shell. 

Commands. 

A simple-command is a sequence of non-blank words separated by 
blanks (a blank is a tab or a space). The first word specifies the name of 
the command to be executed. Except as specified below, the remaining 
words are passed as arguments to the invoked command. The command 
name is passed as argument 0 (see ezec(2)). The value of a simple- 
command is its exit status if it terminates normally, or (octal) 
200-i-sfafus if it terminates abnormally (see signal(Z) for a list of status 
values). 

A pipeline is a sequence of one or more commands separated by j (or, for 
historical compatibility, by ''). The standard output of each command 
but the last is connected by a pipe (2) to the standard input of the next 
command. Each command is run as a separate process: the shell waits 
for the last command to terminate. 

A list is a sequence of one or more pipelines separated by ;, &, &Sc, or ||, 
and optionally terminated by ; or Sc. Of these four symbols. ; and Sc have 
equal precedence, which is lower than that of ScSc and ||. The symbols ScSc 
and II also have equal precedence. A semicolon (;) causes sequential exe¬ 
cution of the preceding pipeline; an ampersand (&) causes asynchronous 
execution of the preceding pipeline (i.e., the shell does nof wait for that 
pipeline to finish). The symbol ScSc (j|) causes the list following it to be 
executed only if the preceding pipeline returns a zero (non-zero) exit 
status. An arbitrary number of new-lines may appear in a list, instead of 
semicolons, to delimit commands. 

A command is either a simple-command or one of the following. Unless 
otherwise stated, the value returned by a command is that of the last 
simple-command executed in the command. 

for name [ in word ... ] do list done 

Each time a for command is executed, name is set to the next 
word taken from the in word list. If in word ... is omitted, then 
the for command executes the do list once for each positional 
parameter that is set (see Parameter Substitution below). Execu¬ 
tion ends when there are no more words in the list, 
case word in [ pattern [ \pattern ] ... ) list ;; ] ... esac 

A case command executes the list associated with the firsi pattern 
that matches word. The form of the patterns is the same as that 
used for file-name generation (see Pile Name Generation below). 


Page 1 


February 17, 1984 









SH(1) 


MUNIX 


SH(1) 


if List then list [ elif list then list ] ... [ else list ] fi 

The List following if is executed and, if it returns a zero exit status, 
the list following the first then is executed. Otherwise, the list fol¬ 
lowing elif is executed and, if its value is zero, the list following 
the next then is executed. Failing that, the else list is executed. 
If no else list or then list is executed, then the if command 
returns a zero exit status, 
while List do list done 

A while command repeatedly executes the while list and, if the exit 
status of the last command in the list is zero, executes the do list : 
otherwise the loop terminates. If no commands in the do list are 
executed, then the while command returns a zero exit status; until 
may be used in place of while to negate the loop termination test. 

(list) 

Execute list in a sub-shell. 

\list:\ 

List is simply executed. 

The following words are only recognized as the first word of a command 
and when not quoted: 

if then else elif fi case esac for while until do done ( { 
Comments. 

A word beginning with # causes that word and all the following characters 
up to a new-line to be ignored. 

Command Substitution. 

The standard output from a-command enclosed in a pair of grave accents 
(") may be used as part or all of a word; trailing new-lines are removed. 

Parameter Substitution. 

The character S is used to introduce substitutable parameters. Posi¬ 
tional parameters may be assigned values by set. Variables may be set 
by writing: 

name =value [ name =value ] ... 

Pattern-matching is not performed on value. 

^[parameter] 

A parameter is a sequence of letters, digits, or underscores (a 
name), a digit, or any of the characters ♦, @, #, ?, —, 8, and !. The 
value, if any, of the parameter is substituted. The braces are 
required only when parameter is followed by a letter, digit, or 
underscore that is not to be interpreted as part of its name. A 
name must begin with a letter or underscore. If parameter is a 
digit then it is a positional parameter. If parameter is • or @, then 
all the positional parameters, starting with 81, are substituted 
(separated by spaces). Parameter 80 is set from argument zero 
when the shell is invoked. 

S \p arame ter :-^ord } 

If parameter is set and is non-null then substitute its value; other¬ 
wise substitute word. 

S [p arame ter:=word\ 

If parameter is not set or is null then set it \,o word: the value of 
the parameter is then substituted. Positional parameters may not 
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be assigned to in this way. 

%\parameter:?word j 

If parameter is set and is non-null then substitute its value; other¬ 
wise. print word and exit from the shell. If word is omitted, then 
the message "parameter null or not set” is printed. 
S(jDara7ne<er:+tyorci j 

If parameter is set and is non-null then substitute word-, otherwise 
substitute nothing. 

In the above, word is not evaluated unless it is to be used as the substi¬ 
tuted string, so that, in the following example, pwd is executed only if d is 
not set or is null: 

echo S|d:—'pwd'! 

If the colon (:) is omitted from the above expressions, then the shell only 
checks whether paramefer is set or not. 

The following parameters are automatically set by the shell: 

# The number of positional parameters in decimal. 

— Flags supplied to the shell on invocation or by the set com¬ 
mand. 

? The decimal value returned by the last synchronously exe¬ 
cuted command. 

S The process number of this shell. 

! The process number of the last background command 

invoked. 

The following parameters are used by the shell: 

HOME The default argument (home directory) for the cd com¬ 
mand. 

PATH The search path for commands (see Execution below). The 
user may not change PATH if executing under rsh. 

CDPATH 

The search path for the cd command. 

MAIL If this variable is set to the name of a mail file, then the 
shell informs the user of the arrival of mail in the specified 
file. 

PSl Primary prompt string, by default "8 ”. 

PS2 Secondary prompt string, by default "> ”. 

IFS Internal field separators, normally space, tab, and new-line. 

The shell gives default values to PATH. PSl. PS2. and IFS, while HOME and 
MAIL are not set at all by the shell (although HOME is set by login^l)). 

Blank Interpretation. 

After parameter and command substitution, the results of substitution 
are scanned for internal field separator characters (those found in IFS) 
and split into distinct arguments where such characters are found. 
Explicit null arguments ("" or ") are retained. Implicit null arguments 
(those resulting trora parameters that have no values) are removed. 

File Name Generation. 

Following substitution, each command word is scanned for the charac¬ 
ters *, ?, and [. If one of these characters appears then the word is 
regarded as a pattern. The word is replaced with alphabetically sorted 
file names that match the pattern. If no file name is found that matches 


Page 3 


February 17, 1984 








SH(1) 


MUNIX 


SH(1) 


[...] 


the pattern, then the word is left unchanged. The character . at the 
start of a file name or immediately following a /, as well as the character 
/ itself, must be matched explicitly. 

♦ Matches any string, including the null string. 

Matches any single character. 

Matches any one of the enclosed characters. A pair of 
characters separated by — matches any character lexically 
between the pair, inclusive. If the first character following 
the opening "[" is a "!” then any character not enclosed is 
matched. 

Quoting. . , ,1 j 

The following characters have a special meaning to the shell and cause 

termination of a word unless quoted: 

; & ( ) I ^ < > new-line space lab 

A character may be quoted, (i.e., made to stand for itself) by preceding it 
with a \ . The pair \ new-line is ignored. All characters enclosed between 
a pair of single quote marks {"), except a single quote, are quoted. 
Inside double quote marks parameter and command substitution 

occurs and \ quotes the characters \, '. ", and S. "S*" is equivalent to 
"SI 82 ...", whereas "S@" is equivalent to "81" "82" .... 

^*'°When used interactively, the shell prompts with the value of PSl before 
reading a command. If at any time a new-line is typed and further input 
is needed to complete a command, then the secondary prompt (i.e., the 
value of PS2) is issued. 

Input/Output. , j. * j 

Before a command is executed, its input and output may be redirected 
using a special notation interpreted by the shell. The following may 
appear anywhere in a simple-command or may precede or follow a com¬ 
mand and are not passed on to the invoked command; substitution 
occurs before word or digit is used; 


<word 

>word 


»word 


«[ — ]word 


<&digit 


Use file word as standard input (file descriptor 0). 

Use file word as standard output (file descriptor 1). If the 
file does not exist then it is created; otherwise, it is trun¬ 
cated to zero length. 

Use file word as standard output. If the file exists then out¬ 
put is appended to it (by first seeking to the end-of-file); 
otherwise, the file is created. 

The shell input is read up to a line that is the same as word, 
or to an end-of-file. The resulting document becomes the 
standard input. If any character of word is quoted, then no 
interpretation is placed upon the characters of the docu¬ 
ment; otherwise, parameter and command substitution 
occurs, (unescaped) \ new-line is ignored, and \ must be 
used to quote the characters \. 8 . and the first character 
of word. If — is appended to «, then all leading tabs are 
stripped from word and from the document. 

The standard input is duplicated from file descriptor digit 
(see dup{2)). Similarly for the standard output using >. 
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<&- The standard input is closed. Similarly for the standard 

output using >. 

If one of the above is preceded by a digit, then the file descriptor created 
is that specified by the digit (instead of the default 0 or 1). For example: 

... 2>&1 

creates file descriptor 2 that is a duplicate of file descriptor 1. 

If a command is followed by & then the default standard input for the 
command is the empty file /dev/null. Otherwise, the environment for the 
execution of a command contains the file descriptors of the invoking 
shell as modified by input/output specifications. 

Redirection of output is not allowed in the restricted shell. 

Environment. 

The environment (see environ{7)) is a list of name-value pairs that is 
passed to an executed program in the same way as a normal argument 
list. The shell interacts with the environment in several ways. On invoca¬ 
tion, the shell scans the environment and creates a parameter for each 
name found, giving it the corresponding value. Executed commands 
inherit the same environment. If the user modifies the values of these 
parameters or creates new ones, none of these affects the environment 
unless the export command is used to bind the shell’s parameter to the 
environment. The environment seen by any executed command is thus 
composed of any unmodified name-value pairs originally inherited by the 
shell, plus any modifications or additions, all of which must be noted in 
export commands. 

The environment for any simple-command may be augmented by 
prefixing it with one or more assignments to parameters. Thus: 

TERM=450 cmd args and 

(export TERM; TERM=450; cmd args) 

are equivalent (as far as the above execution of cmd is concerned). 

If the —k flag is set, all keyword arguments are placed in the environ¬ 
ment, even if they occur after the command name. The following first 
prints a=b c and then c: 

echo a=b c 
set —k 
echo a=b c 

Signals. 

The INTERRUPT and QUIT signals for an invoked command are ignored if 
the command is followed by &; otherwise signals have the values inher¬ 
ited by the shell from its parent, with the exception of signal 11 (but see 
also the trap command below). 

Execution. 

Each time a command is executed, the above substitutions are carried 
out. Except for the Special Commands listed below, a new process is 
created and an attempt is made to execute the command via exec(2). 

The shell parameter PATH defines the search path for the directory con¬ 
taining the command. Alternative directory names are separated by a 
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colon (:). The default path is :/bin;/usr/bin (specifying the current 
directory, /bin, and /usr/bin, in that order). Note that the current 
directory is specified by a null path name, which can appear immediately 
after the equal sign or between the colon delimiters anywhere else in the 
path list. If the command name contains a / then the search path is not 
used; such commands will not be executed by the restricted shell. Other¬ 
wise, each directory in the path is searched for an executable file. If the 
file has execute permission but is not an a.out file, it is assumed to be a 
file containing shell commands. A sub-shell (i.e., a separate process) is 
spawned to read it. A parenthesized command is also executed in a sub¬ 
shell. 

Special Commands. 

The following commands are executed in the shell process and, except as 
specified, no input/output redirection is permitted for such commands; 

No effect; the command does nothing. A zero exit code is 
returned. 

. file Read and execute commands from file and return. The search 
path specified by PATH is used to find the directory containing/lie. 
break[ n ] 

Exit from the enclosing for or while loop, if any. If n is specified 
then break n levels, 
continue [ n ] 

Resume the next iteration of the enclosing for or while loop. If n 
is specified then resume at the n-th enclosing loop, 
cd [ arg ] 

Change the current directory to arg. The shell parameter HOME is 
the default arg. The shell parameter CDPATH defines the search 
path for the directory containing arg. Alternative directory 
names are separated by a colon (:). The default path is <null> 
(specifying the current directory). Note that the current direc¬ 
tory is specified by a null path name, which can appear immedi¬ 
ately after the equal sign or between the colon delimiters any¬ 
where else in the path list. If arg begins with a / then the search 
path is not used. Otherwise, each directory in the path is 
searched for arg. The cd command may not be executed by rsh. 
eval[ arg ... ] 

The arguments are read as input to the shell and the resulting 
command(s) executed, 
exec [ arg ... ] 

The command specified by the arguments is executed in place of 
this shell without creating a new process. Input/output argu¬ 
ments may appear and, if no other arguments are given, cause the 
shell input/output to be modified, 
exit [ n ] 

Causes a shell to exit with the exit status specified by n. If n is 
omitted then the exit status is that of the last command executed 
(an end-of-file will also cause the shell to exit.) 
export [ name ... ] 

The given names are marked for automatic export to the environ¬ 
ment of subsequently-executed commands. If no arguments are 
given, then a list of all names that are exported in this shell is 
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printed. 

newgrp [ arg ... ] 

Equivalent to exec newgrp arg _ 

read [ name ... ] 

One line is read from the standard input and the first word is 
assigned to the first name, the second word to the second name, 
etc., with leftover words assigned to the last name. The return 
code is 0 unless an end-of-file is encountered, 
readonly [ name ... ] 

The given names are marked readonly and the values of the these 
names may not be changed by subsequent assignment. If no argu¬ 
ments are given, then a list of all readonly names is printed, 
set [ —ekntuvx [ arg ... ] ] 

—e Exit immediately if a command exits with a non-zero exit 

status. 

-k All keyword arguments are placed in the environment for a 
command, not just those that precede the command name. 

—n Read commands but do not execute them. 

—t Exit after reading and executing one command. 

—u Treat unset variables as an error when substituting. 

—V Print shell input lines as they are read. 

—X Print commands and their arguments as they are executed. 

— Do not change any of the flags; useful in setting SI to —. 

Using + rather than - causes these flags to be turned off. These 
flags can also be used upon invocation of the shell. The current 
set of flags may be found in S—. The remaining arguments are 

positional parameters and are assigned, in order, to SI, S2. If 

no arguments are given then the values of all names are printed, 
shift [ n ] 

The positional parameters from Sn+1 ... are renamed SI_ If n 

is not given, it is assumed to be 1. 

test 

Evaluate conditional expressions. See fesf(l) for usage and 
description. 

times 

Print the accumulated user and system times for processes run 
from the shell, 
trap [ arg ] [ n ] ... 

arg is a command to be read and executed when the shell receives 
signal(s) n. (Note that arg is scanned once when the trap is set 
and once when the trap is taken.) Trap commands are executed in 
order of signal number. Any attempt to set a trap on a signal that 
was ignored on entry to the current shell is ineffective. An 
attempt to trap on signal 11 (memory fault) produces an error. If 
arg is absent then all trap(s) n are reset to their original values. 
If arg is the null string then this signal is ignored by the shell and 
by the commands it invokes. If n is 0 then the command arg is 
executed on exit from the shell. The trap command with no argu¬ 
ments prints a list of commands associated with each signal 
number. 

ulimil [ —fp ] [ n ] 

imposes a size limit of n 
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—f imposes a size limit of n blocks on files written by child 

processes (files of any size may be read). With no argument, 
the current limit is printed. 

—p changes the pipe size to n (UNIX System/RT only). 

If no option is given, —f is assumed. 

umask [ nnn ] / i- • 

The user file-creation mask is set to nnn (see umask^Z)). If nnn is 
omitted, the current value of the mask is printed, 
wail [ n ] 

Wait for the specified process and report its termination status. If 
n is not given then all currently active child processes are waited 
for and the return code is zero. 

Invocation. 

If the shell is invoked through exec (2) and the first character of argu¬ 
ment zero is —, commands are initially read from /elc/profile and then 
from IHOME/.pro file, if such files exist. Thereafter, commands are read 
as described below, which is also the case when the shell is invoked as 
/bin/sh. The flags below are interpreted by the shell on invocation only; 
Note that unless the -c or -s flag is specified, the first argument is 
assumed to be the name of a file containing commands, and the remain¬ 
ing arguments are passed as positional parameters to that command file: 

—c string 

If the -c flag is present then commands are read from string. 

—s If the —s flag is present or if no arguments remain then com¬ 

mands are read from the standard input. Any remaining argu¬ 
ments specify the positional parameters. Shell output is writ¬ 
ten to file descriptor 2. 

_i If the —i flag is present or if the shell input and output are 

attached to a terminal, then this shell is interactive. In this 
case TERMINATE is ignored (so that kill 0 does not kill an interac¬ 
tive shell) and INTERRUPT is caught and ignored (so that wait is 
interruptible). In all cases. QUIT is ignored by the shell. 

—r If the —r flag is present the shell is a restricted shell. 

The remaining flags and arguments are described under the set com¬ 
mand above. 

Rsh Only. 

Esh is used to set up login names and execution environments whose 
capabilities are more controlled than those of the standard shell. The 
actions of rsh are identical to those of sh, except that the following are 
disallowed: 

changing directory (see cd(l)), 
setting the value of SPATH. 

specifying path or command names containing /, 
redirecting output (> and >>). 

The restrictions above are enforced after .profile is interpreted. 

When a command to be executed is found to be a shell procedure, rsh 
invokes sh to execute it. Thus, it is possible to provide to the end-user 
shell procedures that have access to the full power of the standard shell, 
while imposing a limited menu of commands; this scheme assumes that 
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the end-user does not have write and execute permissions in the same 
directory. 

The net effect of these rules is that the writer of the .profile has com¬ 
plete control over user actions, by performing guaranteed setup actions 
and leaving the user in an appropriate directory (probably not the login 
directory). 

The system administrator often sets up a directory of commands (i.e., 
/usr/rbin) that can be safely invoked by rsh. Some systems also provide 
a restricted editor red. 

EXIT STATUS 

Errors detected by the shell, such as syntax errors, cause the shell to 
return a non-zero exit status. If the shell is being used non-interactively 
then execution of the shell file is abandoned. Otherwise, the shell 
returns the exit status of the last command executed (see also the exit 
command above). 

FILES 

/etc/profile 
SHOME/.profile 
/tmp/sh* 

/dev/null 

SEE ALSO 

cd(l), env(l), login(l), newgrp(l), test(l), umask(l), dup(2), exec(2), 
fork(2), pipe(2), signal(2), ulimit(2), umask(2), wait(2), a.out(5), 
profile(5), environ(7). 

BUGS 

The command readonly (without arguments) produces the same output 
as the command export. 

If « is used to provide standard input to an asynchronous process 
invoked by &, the shell gets mixed up about naming the input document; 
a garbage file /tmp/sh* is created and the shell complains about not 
being able to find that file by another name. 
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NAME 

size — size of an object file 

SYNOPSIS 

size [ object ... ] 

DESCRIPTION 

Size prints the (decimal) number of bytes required by the text, data, bss 
and stack portions, and their sum in octal and decimal, of each object- 
file argument. If no file is specified, a.out is used. 

SEE ALSO 

a.out(5) 
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NAME 

sleep — suspend execution for an interval 

SYNOPSIS 

sleep time 

DESCRIPTION 

Sleep suspends execution for time seconds. It is used to execute a com¬ 
mand after a certain amount of time as in: 

(sleep 105; command)«Sc 

or to execute a command every so often, as in: 

while true 
do 

command 
sleep 37 

done 

SEE ALSO 

alarm(2), sleep(3) 

BUGS 

Time must be less than 65536 seconds. 
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NAME 

sno — SNOBOL interpreter 

SYNOPSIS 

sno [ files ] 

DESCRIPTION 

Sho is a SNOBOL compiler and interpreter (with slight differences). Sno 
obtains input from the concatenation of the named files and the stan¬ 
dard input. All input through a statement containing the label end is 
considered program and is compiled. The rest is available to syspit. 

Sno differs from SNOBOL in the following ways: 

There are no unanchored searches. To get the same effect: 

a *• b unanchored search for 6. 

a ‘x* b = X cunanchored assignment 

There is no back referencing. 

X = "abc" 

a •x* X is an unanchored search for abc. 

Function declaration is done at compile time by the use of the 
(non-unique) label define. Execution of a function call begins at 
the statement following the define. Functions cannot be defined 
at run time, and the use of the name define is preempted. There is 
no provision for automatic variables other than parameters. 
Examples: 

define f( ) 
define f(a, b, c) 

All labels except define (even end) must have a non-empty state¬ 
ment. 

Labels, functions and variables must all have distinct names. In 
particular, the non-empty statement on end cannot merely name 
a label. 

If start is a label in the program, program execution will start 
there. If not, execution begins with the first executable state¬ 
ment: define is not an executable statement. 

There are no builtin functions. 

Parentheses for arithmetic are not needed. Normal precedence 
applies. Because of this, the arithmetic operators / and • must be 
set off by spaces. 

The right side of assignments must be non-empty. 

Either ' or " may be used for literal quotes. 

The pseudo-variable sysppt is not available. 

SEE ALSO 

awk(l). 

'•SNOBOL, a String Manipulation Language,” by D. J. Farber, R. E. Griswold 

and I. P. Polonsky, 7/10/ 11 (1964), pp. 21-30. 
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NAME 

soelim — eliminate .so's from nroff input 

SYNOPSIS 

soelim [ file ... ] 

DESCRIPTION 

Soelim reads the specified files or the standard input and performs the 
textual inclusion implied by the nroff directives of the form 

.so somefile 

when they appear at the beginning of input lines. This is useful since 
programs such as tbl do not normally do this; it allows the, placement of 
individual tables in separate files to be run as a part of a large document. 

An argument consisting of a single minus (—) is taken to be a file name 
corresponding to the standard input. 

Note that inclusion can be suppressed by using instead of i.e. 

'so /usr/lib/tmac.s 
A sample usage of soelim would be 

soelim exum?.n I tbl | nroff —ms | col | Ipr 

SEE ALSO 

colcrt( 1). more(l) 

AUTHOR 

William Joy 

BUGS 

The format of the source commands must involve no strangeness — 
exactly one blank must precede and no blanks follow the file name. 
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NAME 

sort — sort or merge files 
SYNOPSIS 

sort [ -mubdfinrLr ] [ -^posl [ -posS ] ] ... [ -o name ] [ -T direc¬ 

tory ] [ name ] ... 

DESCRIPTION 

Sort sorts lines of all the named files together and writes the result on 
the standard output. The name ’ means the standard input. If no 
input files are named, the standard input is sorted. 

The default sort key is an entire line. Default ordering is lexicographic 
by bytes in machine collating sequence. The ordering is affected globally 
by the following options, one or more of which may appear. 

b Ignore leading blanks (spaces and tabs) in field comparisons. 

d ’Dictionary’ order: only letters, digits and blanks are significant in 
comparisons. 

f Fold upper case letters onto lower case. 

i Ignore characters outside the ASCII range 040-0176 in nonnumeric 
comparisons. 

n An initial numeric string, consisting of optional blanks, optional 
minus sign, and zero or more digits with optional decimal point, is 
sorted by arithmetic value. Option n implies option b. 

r Reverse the sense of comparisons. 

tx ’Tab character’ separating fields is x. 

The notation +posl —yos^restricts a sort key to a field beginning at posi 
and ending just before pos2. Posl and pos2 each have the form m.n, 
optionally followed by one or more of the fiags bdfinr, where m tells a 
number of fields to skip from the beginning of the line and n tells a 
number of characters to skip further. If any fiags are present they over¬ 
ride all the global ordering options for this key. If the b option is in 
effect n is counted from the first nonblank in the field; b is attached 
independently \.opos2. A missing .n means .0; a missing -pos,? means the 
end of the line. Under the —tx option, fields are strings separated by x; 
otherwise fields are nonempty nonblank strings separated by blanks. 

When there are multiple sort keys, later keys are compared only after all 
earlier keys compare equal. Lines that otherwise compare equal are 
ordered with all bytes significant. 

These option arguments are also understood: 

c Check that the input file is sorted according to the ordering rules; 
give no output unless the file is out of sort. 

m . Merge only, the input files are already sorted. 

o The next argument is the name of an output file to use instead of 
the standard output. This file may be the same as one of the inputs. 

T The next argument is the name of a directory in which temporary 
files should be made. 
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u Suppress all but one in each set of equal lines. Ignored bytes and 
bytes outside keys do not participate in this comparison. 

Examples. Print in alphabetical order all the unique spellings in a list of 
words. Capitalized words differ from uncapitalized. 

sort —u +0f +0 list 

Print the password file (passtyd(5)) sorted by user id number (the 3rd 
colon-separated field). 

sort —t: -H2n /etc/passwd 

Print the first instance of each month in an already sorted file of (rnonth 
day) entries. The options —um with just one input file make the choice of 
a unique representative from a set of equal lines predictable. 

sort —um H-0 —1 dates 


FILES 


/usr/tmp/stm*. /tmp/*; first and second tries for temporary files 


SEE ALSO , V . , V 

uniq(l). comm(l), rev(l), join(l) 

DIAGNOSTICS . . . ui j-. 

Comments and exits with nonzero status for various trouble conditions 


BUGS 


and for disorder discovered under option 
Very long lines are silently truncated. 
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NAME 

spell, spellin, spellout — find spelling errors 
SYNOPSIS 

spell [ option ] ... [ file ] ... 

/usr/dicl/spellin [ list ] 

/usr/dict/spellout [ —d ] list 
DESCRIPTION 

Spell collects words from the named documents, and looks them up in a 
spelling list. Words that neither occur among nor are derivable (by 
applying certain inflections, prefixes or suffixes) from words in the spel¬ 
ling list are printed on the standard output. If no files are named, words 
are collected from the standard input. 

Spell ignores most troff, tbl and egn(l) constructions. 

Under the —v option, all words not literally in the spelling list are printed, 
and plausible derivations from spelling list words are indicated. 

Under the —b option. British spelling is checked. Besides preferring cen¬ 
tre. colour, speciality, travelled, etc., this option insists upon -ise in 
words like standardise, Fowler and the OED to the contrary notwith¬ 
standing. 

Under the —x option, every plausible stem is printed with *=' for each 
word. 

The spelling list is based on many sources, and while more haphazard 
than an ordinary dictionary, is also more effective in respect to proper 
names and popular technical words. Coverage of the specialized vocabu¬ 
laries of biology, medicine and chemistry is light. 

Pertinent auxiliary files may be specified by name arguments, indicated 
below with their default settings. Copies of all output are accumulated in 
the history file. The stop list filters out misspellings (e.g. 
thier=thy—y+ier) that would otherwise pass. 

Two routines help maintain the hash lists used by spell. Both expect a list 
of words, one per line, from the standard input. Spellin adds the words 
on the standard input to the preexisting list and places a new list on the 
standard output. If no list is specified, the new list is created from 
scratch. Spellout looks up each word in the standard input and prints on 
the standard output those that are missing from (or present on, with 
option —d) the hash list. 

FILES 

D=/usr/dict/hlist[ab]: hashed spelling lists, American & British 
S=/usr/dict/hstop: hashed stop list 
H=/usr/dict/spellhist; history file 
/usr/lib/spell 

deroff(l), sort(l), tee(l). sed(l) 

BUGS 

The spelling list's coverage is uneven; new installations will probably wish 
to monitor the output for several months to gather local additions. 

British spelling was done by an American. 
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NAME 

spline — interpolate smooth curve 

SYNOPSIS 

spline [ options ] 

DESCRIPTION 

Spline takes pairs of numbers from the standard input as abscissas and 
ordinates of a function. It produces a similar set, which is approximately 
equally spaced and includes the input set, on the standard output. The 
cubic spline output (R. W. Hamming, Numerical Methods for Scientists 
and Engineers, 2nd ed., pp. 349fT) has two continuous derivatives, and 
sufficiently many points to look smooth when plotted, for example by 
flrraph.(lG). 

The following options are recognized, each as a separate argument: 

—a Supply abscissas automatically (they are missing from the input); 
spacing is given by the next argument, or is assumed to be 1 if next 
argument is not a number. 

—k The constant k used in the boundary value computation: 

yo=*yi'. .yn=*vn-i 

is set by the next argument (default k = 0). 

—n Space output points so that approximately n intervals occur 

between the lower and upper x limits (default n = 100). 

—p Make output periodic, i.e., match derivatives at ends. First and last 

input values should normally agree. 

-X Next 1 (or 2) arguments are lower (and upper) x limits. Normally, 
these limits are calculated from the data. Automatic abscissas 
start at lower limit (default 0). 

SEE ALSO 

graph(lG). 

DIAGNOSTICS 

When data is not strictly monotone in x, spline reproduces the input 
without interpolating extra points. 

BUGS 

A limit-of 1,000 input points is enforced silently. 
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NAMfi 

split — split a file into pieces 
SYNOPSIS 

split [ -n ] [ file [ name ] ] 

DESCRIPTION 

Split reads file and writes it in n-line pieces (default 1000), as many as 
necessary, onto a set of output files. The name of the first output file is 
name with aa appended, and so on lexicographically. If no output name 
is given, x is default. 

If no input file is given, or if — is given in its stead, then the standard 
input file is used. 
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NAME 

stctrl.stskip — special streamer features, skip files 
SYNOPSIS 

stctrl [-e] [-r] 
siskip count 

DESCRIPTION 

. Stctrl is used to execute special streamer commands. The possible 
options are; 

—e to erase the whole tape. 

—r to make a retension of the tape. 

Stskip skips the next files on the tape. Count holds the number of files to 
be skipped. 

These two commands always refer to streamer drive 0. 

FILES 

/dev/rstO 

/dev/nrstO 

SEE ALSO 
st(4) 
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NAHE 

stksiz — set stacksize 

SYNOPSIS 

stksiz size file ... 

DESCRIPTION 

Stksiz sets the stacksize of the executable program file to size bytes. 

A default size of 2k bytes is set by the linker. For larger or recursive 
programs you will have to increase this amount. See in the EXAMPLE sec¬ 
tion of adb(l) how to recognize a stack overflow. 

The stksiz command is necessary because an automatic expansion of the 
stack in case of a stack overflow is in general impossible with the MC 
66000, as it knows no bus-error-recovery. The system can recover from a 
stack overflow and increase the stack size automatically, if the executed 
code was e.g. "move.l xxx,-2042(a6)'', or even "move.w xxx.-(a7)", but not 
from "move.l xxx,-(a7)", as there is no way of finding out whether the 
error occurred on the first or second halfword. 

With the MC 68010 this command is obsolete. 

SEE ALSO 

size(l) 
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NAME 

strings - find the printable strings in a object, or other binary, file 
SYNOPSIS 

strings [ “ ] [ “O ] [ —number ] file ... 

DESCRIPTION 

Strings looks for ascii strings in a binary file. A string is any sequence of 
4 or more printing characters ending with a newline or a null. Unless the 
— flag is given. stHngs only looks in the initialized data space of object 
files. If the —o flag is given, then each string is preceded by its offset in 
the file (in octal). If the —number flag is given then number is used as 
the minimum string length rather than 4. 

Strings is useful for identifying random object flies and many other 
things. 

SEE ALSO 

odd) 

BUGS 

The algorithm for identifying strings is extremely primitive 
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NAME 

strip - remove symbols and relocation bits 
SYNOPSIS 

strip name ... 

DESCRIPTION 

Strip removes the symbol table and relocation bits ordinarily attached to 
the output of the assembler and link editor. This is useful to save space 
after a program has been debugged. 

The effect of strip is the same as use of the —s option of Id. 

If name is an archive file, strip will remove the local symbols from any 
a.out format files it finds in the archive. Certain libraries, such as those 
residing in /lib, have no need for local symbols. By deleting them, the 
size of the archive is decreased and link editing performance is 
increased. 

FILES 

/tmp/stm* temporary file 

SEE ALSO 

ld(l). 
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NAME 


struct — structure Fortran programs 


SYNOPSIS 

struct [ option ] 


file 


—1 


—a 


DESCRIPTION 

StTuct translates the Fortran program specified by file (standard input 
default) into a Ratfor program. Wherever possible. Ratfor control con¬ 
structs replace the original Fortran. Statement numbers appear only 
where still necessary. Cosmetic changes are made, including changing 
Hollerith strings into Quoted strings and relational operators into sym¬ 
bols (.e.g. ‘.GT.’ into ’>’). The output is appropriately indented. 

The following options may occur in any order. 

s Input is accepted in standard format, i.e. comments are specified 
by a c. C, or • in column 1, and continuation lines are specified by 
a nonzero, nonblank character in column 6. Normally, a state¬ 
ment whose first nonblank character is not alphanumeric is 
treated as a continuation. 

Do not turn computed goto statements into switches. (Ratfor does 
not turn switches back into computed goto statements.) 

Turn sequences of else ifs into a non-Ratfor switch of the form 
switch j 

case predl; code 
case pred2: code 
case pred3. code 
default: code 

! 

The case predicates are tested in order; the code appropriate to 
only one case is executed. This generalized form of switch state¬ 
ment does not occur in Ratfor. 

Generate goto's instead of multilevel break statements. 

Generate goto's instead of multilevel next statements. 

If n is 0 (default), place code within a loop only if it can lead to an 
iteration of the loop. If n is nonzero, admit code segments with 
fewer than n statements to a loop if otherwise the loop would have 
exits to several places including the segment, and the segment can 
be reached only from the loop. 


-b 


—n 


—en 


FILES 


/tmp/struct* 

/usr/lib/struct/* 


SEE ALSO 

f77(l) 

BUGS 


Struct knows Fortran 66 syntax, but not full Fortran 77 (alternate 
returns. IF...THEN...ELSE, etc.) 

If an input Fortran program contains identifiers which are reserved 
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words in Ratfor. the structured version of the program will not be i 
Ratfor program. 

Extended range DO's generate cryptic errors. 

Columns 73-80 are not special even when -s is in effect. 

■Will not generate Ratfor FOR statements. 


valid 
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NAME 


slty — set the options for a terminal 


SYNOPSIS 

stty [ ~a ] [ —g ] [ options ] 

DESCRIPTION 

Stty sets certain terminal I/O options for the device that is the current 
standard input; without arguments, it reports the settings of certain 
options; with the —a option, it reports all of the option settings; with the 
—g option, it reports current settings in a form that can be used as an 
argument to another stty command. Detailed information about the 
modes listed in the first five groups below may be found in fermio(4). 
Options in the last group are implemented using options in the previous 
groups. Note that many combinations of options make no sense, but no 
sanity checking is performed. The options are selected from the follow¬ 
ing: 

Control Modes 

parenb (—parenb) enable (disable) parity generation and detection. 

parodd (—parodd) select odd (even) parity. 

cs5 cs6 cs7 cs8 select character size (see term.io{4)). 

0 hang up phone line immediately. 

50 75 110 134 150 200 300 600 1200 1800 2400 4800 9600 exta extb 

Set terminal baud rate to the number given, if possi¬ 
ble. (All speeds are not supported by all hardware 
interfaces.) 

hang up (do not hang up) a DATA-PHONE* data set con¬ 
nection on last close, 
same as hupcl (—hupcl). 
use two (one) stop bits per character, 
enable (disable) the receiver, 
assume a line without (with) modem control. 


hupcl (—hupcl) 


hup (—hup) 
cstopb (—cstopb) 
cxead (—cread) 
clocal (—clocal) 
Input Modes 

ignbrk (—ignbrk) 
brkint (—brkinl) 
ignpar (—ignpar) 
parmrk (—peururk) 

inpck (—inpck) 
istrip (—istrip) 
inlcr (—inlcr) 
igncr (—igncr) 
icml (—icml) 
iuclc (—iuclc) 

ixon (—ixon) 


ixany (—ixany) 
ixoff (-ixoff) 

Output Modes 


ignore (do not ignore) break on input, 
signal (do not signal) INTR on break, 
ignore (do not ignore) parity errors. 

mark (do not mark) parity errors (see fermto(4)). 

enable (disable) input parity checking. 

strip (do not strip) input characters to seven bits. 

map (do not map) NL to CR on input. 

ignore (do not ignore) CR on input. 

map (do not map) CR to NL on input. 

map (do not map) upper-case alphabetics to lower 

case on input. 

enable (disable) START/STOP output control. Output is 
stopped by sending an ASCII DC3 and started by send¬ 
ing an ASCII DCl. 

allow any character (only DCl) to restart output, 
request that the system send (not send) START/STOP 
characters when the input queue is nearly empty/full. 
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opost (—opost) 

olcuc (—olcuc) 

onlcr (—onlcr) 
ocml (—ocml) 
onocr (—onocr) 
onlret (—onlrel) 

ofill (—ofill) 
ofdel (—ofdel) 
crO crl cr2 cr3 

nlO nil 
tabO tabl tab2 tab3 


post-process output (do not post-process output; 
ignore all other output modes). 

map (do not map) lower-case alphabetics to upper 
case on output. 

map (do not map) NL to CR-NL on output. 

map (do not map) CR to NL on output. 

do not (do) output CRs at column zero. 

on the terminal NL performs (does not perform) the CR 

function. 

use fill characters (use timing) for delays, 
fill characters are DELs (NULs). 

select style of delay for carriage returns (see ter- 
mio(4)). 

select style of delay for line-feeds (see termio{4)). 


bsO bsl 
ffO ffl 
vtO vtl 
Local Modes 
isig (-isig) 

icanon (—icanon) 

xcase (—xcase) 

echo(—echo) 
echoe(—echoe) 


echok(—echok) 
Ifkc (-like) 
echonl (—echonl) 
noflsh (—noflsh) 
stwrap (—stwrap) 

stflush (—stflush) 

stappl (—stappl) 

Control Assignments 
control-character 


select style of delay for horizontal tabs (see ter^ 
Tnio(4)). 

select style of delay for backspaces (see ferm'io(4)). 
select style of delay for form-feeds (see term.io{A)). 
select style of delay for vertical tabs (see termio{A)). 

enable (disable) the checking of characters against 
the special control characters INTR and QUIT, 
enable (disable) canonical input (ERASE and KILL pro¬ 
cessing). 

canonical (unprocessed) upper/lower-case presenta¬ 
tion. 

echo back (do not echo back) every character typed, 
echo (do not echo) ERASE character as a backspace- 
space-backspace string. Note: this mode will erase the 
ERASEed character on many CRT terminals; however, it 
does not keep track of column position and, as a 
result, may be confusing on escaped.characters, tabs, 
and backspaces. 

echo (do not echo) NL after KILL character. 

the same as echok (—echok); obsolete. 

echo (do not echo) NL. 

disable (enable) flush after INTR or QUIT. 

disable (enable) truncation of lines longer than 79 

characters on a synchronous line. 

enable (disable) flush on a synchronous line after 
every write{Z). 

use application mode (use line mode) on a synchro¬ 
nous line. 

c 

set control-character to c, where control-character is 
erase, kill, intr, quit, eof, eol, min, or time (min and 
time are used with —icanon; see termio^A)). If c is pre¬ 
ceded by an (escaped from the shell) caret (''), then 
the value used is the corresponding CTRL character 
(e.g., "-d” is a CTRL-d); is interpreted as DEL and 
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••—" is interpreted as undefined, 
line i set line discipline to i (0 < t < 127 ). 

Combination Modes 

evenp or parity enable parenb and cs7. 

oddp enable parenb, cs7, and parodd. 

—parity, —evenp, oi—oddp 

disable parenb, and set cs6. 
raw {—raw or cooked) 

enable (disable) raw input and output (no ERASE, KILL, 
INTR, QUIT, EOT, or output post processing), 
nl (—nl) unset (set) icml, onicr. In addition —nl unsets inlcr, 

igncr, ocml, and onlret. 

lease (—lease) set (unset) xcase, iuclc, and olcuc. 

LCASE (—LCASE) same as lease (-lease), 

tabs (—tabs or tab3) 

preserve (expand to spaces) tabs when printing, 
ek reset ERASE and KILL characters back to normal BS 

and CTRL-X. 

sane resets all modes to some reasonable values. 

term. set all modes suitable for the terminal type term, 

where term is one of tty33, tty37, vt05, tn300, ti700. or 
tek. 

SEE ALSO 

tabs(l). ioctl(2), termio{4) 
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NAME 

style - analyze surface characteristics of a document 
SYNOPSIS 


style [ —ml ] 
] file ... 


[ mm ] [ -a ] [ -e ] [ -1 num ] [ -r num ] [ -p ] [ -P 


DESCRIPTION 

m?nt surface characteristics of the writing style of a docu- 

readability, sentence length and structure, word 
rferoff h f sentence openers. Because style runs 

fnTw.w f°"^^tting header files should be 

included as part of the input. The default macro package -ms may be 

listTlSould'^t'"^® -hichLusef der^To Lip 

Ti,^ document contains many lists of non- 

SarlctSstlcs* ° options are used to locate sentences with certain 


a print all sentences with their length and readability index. 

—e print all sentences that begin with an expletive. 

p print all sentences that contain a passive verb. 

—Inum 

print all sentences longer than num. 

—mum 

print all sentences whose readability index is greater than num. 

-P print parts of speech of the words in the document. 

SEE ALSO 

derofT(l). diction(l) 

BUGS 

Use of non-standard formatting macros may cause incorrect sentence 
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NAME 

su — become super-user or another user 
SYNOPSIS 

su [ — ] [ name [ arg •.. ] ] 

DESCRIPTION 

Su allows one to become another user without logging off. The default 
user name is root (i.e., super-user). 

To use su, the appropriate password must be supplied (unless one is 
already super-user). If the password is correct, su will execute a new 
shell with the user ID set to that of the specified user. To restore normal 
user ID privileges, type an EOF to the new shell. 

Any additional arguments are passed to the shell, permitting the super- 
user to run shell procedures with restricted privileges (an arg of the 
form —c string executes string via the shell). When additional arguments 
are passed, /bin/sh is always used. When no additional arguments are 
passed, su uses the shell specified in the password file. 

An initial — flag causes the environment to be changed to the one that 
would be expected if the user actually logged in again. This is done by 
invoking the shell with an argO of — su causing the .profile in the home 
directory of the new user ID to be executed. Note that the .profile can 
check argO for — sh oi— su to determine how it was invoked. 

EXAMPLES 

su 

su - adm -c "/usr/lib/acct/ckpacct” 

FILES 

/etc/passwd system’s password file 
SHOME/.profile user's profile 
SEE ALSO 

env(l), login(l), sh(l), environ(7). 
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NAME 

sum — sum and count blocks in a file 

SYNOPSIS 

sum file 

DESCRIPTION 

5iim calculates and prints a 16-bit checksum for the named file, and also 
prints the number of blocks in the file. It is typically used to look for bad 
spots, or to validate a file communicated over some transmission line. 

SEE ALSO 

wc(l) 

DIAGNOSTICS 

■Read error' is indistinuishable from end of file on most devices; check 
the block count. 
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NAME 


tabs — set tabs on a terminal 


SYNOPSIS 

tabs [ tabspec ] [ +inn ] [ -Ttype ] 

DESCRIPTION 

Tabs sets the tab stops on the user's terminal according to the tab 
^ecification iabspec after clearing any previous settings. The user 

"ardwat ta°bT' ' --otaly-aeUable 

Users 0 / GE TermlNet terminals should be aware that they behave in a 
different way than most other terminals for some tab settings: the first 
number m a list of tab settings becomes the left margin on a TermiNet 
terminal. Thus, any list of tab numbers whose first element is other than 
margin to be left on a TermiNet. but not on other terminals. A 
tab list beginning with 1 causes the same effect regardless of terminal 

set a left margin on some other terminals, although 
in a dijfTerent way (see below). 

Four types of tab specification are accepted for tabspec: "canned " 
repetitive arbitrary, and file. If no tabspec is given, the default value is 

nL f standard" tabs. The lowest column number is 1. 

Note that for tabs, column 1 always refers to the leftmost column on a 

Drs™00s,and"DTsM"50°'' 3 “' 


—code 


The legal codes 


—a 


-a2 


—c 


—c2 


-c3 


-f 


—s 


Gives the name of one of a set of "canned" tabs, 
and their meanings are as follows: 

1.10.16.36.72 
Assembler. IBM S/370, first format 

1.10.16.40.72 

Assembler. IBM S/370, second format 

1.8.12.16.20.55 
COBOL, normal format 
1.6.10.14.49 

COBOL compact format (columns 1-6 omitted). Using this code, 
the first typed character corresponds to card column 7. one 
space gets you to column 8. and a tab reaches column 12. Files 
lows^ setup should include a format specification as fol- 

<:t—c2 m6 s66 d;> 

1.6.10.14,18.22.26.30.34.38.42.46.50.54.58.62.67 
COBOL compact format (columns 1-6 omitted), with more tabs 
tnan ~c2. This is the recommended format for COBOL. The 
appropriate format specification is: 

<:t—c3 m6 s66 d:> 

1.7.11.15,19.23 

FORTRAN 

1.5,9.13.17.21.25,29.33.37.41,45.49.53.57 61 
PL/1 

1.10.55 
SNOBOL 
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-u 1.12.20.44 

UNIVAC 1100 Assembler 

In addition to these ‘’canned" formats, three other types exist. 

-n A repetitive specification requests tabs at columns 1+n. l+2*n. 

etc Note that such a setting leaves a left margin of n columns on 
TermiNet terminals only. Of particular importance is the value 
-8- this represents the UNIX System “standard" tab setting, and is 
the most likely tab setting to be found at a terminal. It is. 
required for use with the nroff -h option for high-speed output. 
Another special case is the value -0. implying no tabs at all. 

The arbitrary format permits the user to type any chosen set of 
numbers, separated by commas, in ascending order. Up to 4U 
numbers are allowed. If any number (except the first one) is pre¬ 
ceded by a plus sign, it is taken as an increment to be added to 
the previous value. Thus, the tab lists 1.10.20.30 and 
1 10 +10.+10 are considered identical. , . *1 

—file If the name of a file is given, tabs reads the first line of the file 
searching for a format specification. If it finds one there, it sets 
the tab stops according to it. otherwise it Sets them as -8. Ihis 
type of specification may be used to make sure that a tabbed file 
is Vinted with correct tab settings, and would be used with the 
pr(l) command: 

tabs — file; pr file 

Any of the following may be used also; if a given fiag occurs more than 
once, the last value given takes effect: 

Tabs usually needs to know the type of terminal in ord^ to set 
tabs and always needs to know the type to set margins. is a 

name listed in ferm(5). If no -T flag is supplied. 
the STERM value in the environment (see enmron(5)). li no typ 
can be found, tabs tries a sequence that will work for many termi- 

n al s 

+mn The margin argument may be used for some terminals. It causes 
all tabs to be moved over n columns by making column n+i the 
left margin. If +m is given without a value of ^ 

assumed is 10. For a TermiNet. the first value m the tab list 
should be 1. or the margin will move even further to the rig • 
The normal (leftmost) margin on most terminals is 
+m0. The margin for most terminals is reset only when the +m 

fiag is given explicitly. 

Tab and margin setting is performed via the standard output. 


DIAGNOSTICS 

illegal tabs 
illegal increment 

unknown tab code 
cant open 


when arbitrary tabs are ordered incorrectly. 

when a zero or missing increment is found in an 

arbitrary specification. 

when a "canned” code cannot be found. 

if —file option used, and file can't be opened. 
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/tie indirection if —file option used and the specification in that file 

points to yet another file. Indirection of this form is 
not permitted. 

SEE ALSO 

nrofT(l). environ(7), term(7). 

BUGS 

There is no consistency among different terminals regarding ways of 
clearing tabs and setting the left margin. 

It is generally impossible to usefully change the left margin without also 
setting tabs. 

Tabs clears only 20 tabs (on terminals requiring a long sequence), but is 
willing to set 40. 
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NAME 

tail — deliver the last part of a file 
SYNOPSIS 

tail [ ±number[lbc] ] [ file ] 

DESCRIPTION 

Tail copies the named file to the standard output beginning at a desig¬ 
nated place. If no file is named, the standard input is used. 

Copying begins at distance +number from the beginning, or —number 
from the end of the input. Number is counted in units of lines, blocks or 
characters, according to the appended option 1, b or c. When no units are 
specified, counting is by lines. 

SEE ALSO 

dd(l) 

BUGS 

Tails relative to the end of the file are treasured up in a buffer, and thus 
are limited in length. Various kinds of anomalous behavior may happen 
with character special files. 
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NAME 

tar — tape archiver 
SYNOPSIS 

tar [ key ] [ name ... ] 

DESCRIPTION 

Tar saves and restores files on magtape. Its actions are controlled by the 
key argument. The key is a string of characters containing at most one 
function letter and possibly one or more function modifiers. Other argu¬ 
ments to the command are file or directory names specifying which files 
are to be dumped or restored. In all cases, appearance of a directory 
name refers to the files and (recursively) subdirectories of that direc¬ 
tory. 

The function portion of the key is specified by one of the following 
letters; 

r The named files are written on the end of the tape. The c func¬ 
tion implies this. 

X The named files are extracted from the tape. If the named file 

matches a directory whose contents had been written onto the 
tape, this directory is (recursively) extracted. The owner, 
modification time, and mode are restored (if possible). If no file 
argument is given, the entire content of the tape is extracted. 
Note that if multiple entries specifying the same file are on the 
tape, the last one overwrites all earlier. 

t The names of the specified files are listed each time they occur on 

the tape. If no file argument is given, all of the names on the tape 
are listed. 

u The named files are added to the tape if either they are not 

already there or have been modified since last put on the tape. 

c Create a new tape; writing begins on the beginning of the tape 

instead of after the last file. This command implies r. 

The following characters may be used in addition to the letter which 
selects the function desired. 

0,....7 This modifier selects the drive on which the tape is mounted. 
The default is 1. 

V Normally tar does its work silently. The v (verbose) option 

causes it to type the name of each file it treats preceded by the 
function letter. With the t function, v gives more information 
about the tape entries than just the name. 

w causes tar to print the action to be taken followed by file name. 

then wait for user confirmation. If a word beginning with 'y' is 
given, the action is performed. Any other input means don’t do 
it. 

f causes tar to use the next argument as the name of the archive 

instead of /dev/mt?. If the name of the file is tar writes to 
standard output or reads from standard input, whichever is 
appropriate. Thus, tar can be used as the head or tail of a filter 
chain Tar can also be used to move hierarchies with the 
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command 

cd fromdir: tar cf - . | (cd todir; tar xf -) 

b causes tar to use the next argument as the blocking factor for 

tape records. The default is 1. the maximum is 127. This option 
should only be used with raw magnetic tape archives (See f 
above). The block size is determined automatically when read¬ 
ing tapes (key letters ‘x’ and't’)- 

1 tells tar to complain if it cannot resolve all of the links to the 

files dumped. If this is not specified, no error messages are 
printed. 

m tells tar to not restore the modification times. The mod time 

will be the time of extraction. 

FILES 

/dev/mt? 

/dev/rmt? 

/tmp/tar* 

DIAGNOSTICS 

Complaints about bad key characters and tape read/write errors. 
Complaints if enough memory is not available to hold the link tables. 

BUGS , 

There is no way to ask for the n-th occurrence of a file. 

Tape errors are handled ungracefully. 

The u option can be slow. 

The b option should not be used with archives that are going to be 
updated. If the archive is on a disk file the b option should not be used 
at all. as updating an archive stored in this manner can destroy it. 

The current limit on file name length is 100 characters. 
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NAME 

tbl - format tables for nroff or troff 
SYNOPSIS 

tbl [ -TX ] [ files ] 

DESCRIPTION 

p>l is a preprocessor that formats tables for riroff{l) or troff{l). The 
input files are copied to the standard output, except for lines between .TS 
and .TE command lines, which are assumed to describe tables and are 
by tbl. (The .TS and .TE command lines are not altereid by 

.TS is followed by global options. The available global options are; 

center center the table (default is left-adjust); 
expand make the table as wide as the current line length; 
box enclose the table in a box; 

doublebox 

enclose the table in a double box; 
allbox enclose each item of the table in a box; 
tab (x) use the character x instead of a tab to separate items in 
a line of input data. 

The global options, if any. are terminated with a semi-colon (;). 

Next come lines describing the format of each line of the table. Each 
such format line describes one line of the actual table, except that the 
last format line (which must end with a period) describes all remaining 
lines of the table. Each column of each line of the table is described by a 
single key-letter, optionally followed by specifiers that determine the 
font and point size of the corresponding item, that indicate where verti¬ 
cal bars are to appear between columns, that determine column width, 
inter-column spacing, etc. The available key-letters are: 

c center item within the column; 
r right-adjust item within the column; 

1 left-adjust item within the column; 

n numerically adjust item in the column: units positions of 
numbers are aligned vertically; 
s span previous item on the left into this column; 
a center longest line in this column and then left-adjust all 
other lines in this column with respect to that centered 
line; 

span down previous entry in this column; 

_ replace this entry with a horizontal line; 

= replace this entry with a double horizontal line. 

The characters B and I stand for the bold and italic fonts, respectively; 
the character | indicates a vertical line between columns. 

The format lines are followed by lines containing the actual data for the 
table, followed finally by .TE. Within such data lines, data items are nor¬ 
mally separated by tab characters. 

If a data line consists of only_or =, a single or double line, respectively, 

is drawn across the table at that point; if a single item in a data line con¬ 
sists of only_or =, then that item is replaced by a single or double line. 
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Full details of all these and other features of tbl are given in the refer¬ 
ence manual cited below. 

The —TX option forces tbl to use only full vertical line motions, making 
the output more suitable for devices that cannot generate partial verti¬ 
cal line motions (e.g.. line printers). 

If no file names are given as arguments, tbl reads the standard input, so 
it may be used as a filter. When it is used with egn(l) or nGgn(l), tbl 
should come first to minimize the volume of data passed through pipes. 

EXAMPLE 

If we let -» represent a tab (which should be typed as a genuine tab), then 
the input; 

.TS 

center box ; 
cB s s 

cl I cl s , 

^ I c c 
1 I n n . 

Household Population 

Town-*Households 

-♦Number-*Size 

Bedminster-»789-»3.26 
Bernards Twp.-»3O07-»3.74 
Bernardsville-»20l8-*3.30 
Bound Brook-»3425-»3.04 
Bridgewater-*7897-»3.81 
Far Hills-»240-*3.19 
.TE 

yields: 


Household Population 

Town 

Households 
Number Size 

Bedminster 
Bernards Twp. 
Bernardsville 
Bound Brook 
Bridgewater 

Far Hills 

789 3.26 

3087 3.74 

2018 3.30 

3425 3.04 

7097 3.81 

240 3.19 


SEE ALSO 

TBL — A Program, to Format Tables by M. E. Lesk 
eqn(l), mm(l), mmt(l), trofT(l), mm(7), mv(7). 

BUGS 

See BUGS under trQff{\). 
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NAME 

tc — phototypesetter simulator 
SYNOPSIS 

tc [ — t ] [ —sn ] [ —pi ] [ file ] 

DESCRIPTION 

Tc interprets its input (standard input default) as device codes for a 
Wang Laboratories. Inc. C/A/T phototypesetter. The standard output of 
tc is intended for a Tektronix 4014 terminal with ASCII and APL character 
sets. The sixteen typesetter sizes are mapped into the 40l4's four sizes; 
the entire TROFF character set is drawn using the 4014’s character gen¬ 
erator, with overstruck combinations where necessary. Typical usage is' 

troff —t files I tc 

At the end of each page, tc waits for a new-line (empty line) from the 
keyboard before continuing on to the next page. In this wait state, the 
command e will suppress the screen erase before the next page; sn will 
cause the next n pages to be skipped; and Icmd will send cmd, to the 
shell. 

The command line options are: 

—t Don’t wait between pages (for directing output into a file). 

—sn Skip the first n pages. 

—pL Set page length to 1; I may include the scale factors p (points), i 
(inches), c (centimeters), and P (picas); default is picas. 

SEE ALSO 

4014(1). sh(l). tplot(lG). trofr(l). 

BUGS 

Font distinctions are lost. 
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NAAE 

tee — pipe fitting 
SYNOPSIS 

tee [ -i ] [ -a ] [ file ] ... 

DESCRIPTION 

Tfee transcribes the standard input to the standard output and makes 
copies in the files. Option -i ignores interrupts; option -a causes the out¬ 
put to be appended to ihe files rather than overwriting them. 
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HATAE 

lest - condition evaluation command 

SYNOPSIS 

test expr 
[ expr ] 

DESCRIPTION 

Test evaluates the expression expr and. if its value is true, returns a zero 
(true) exit status: otherwise, a non-zero (false) exit status is returned; 
test also returns a non-zero exit status if there are no arguments. The 
following primitives are used to construct expr: 

—T file true if file exists and is readable. 

—w file true if file exists and is writable. 

true if file exists and is executable, 
true if file exists and is a regular file, 
true if file exists and is a directory, 
true if file exists and is a character special file, 
true if file exists and is a block special file, 
true if file exists and is a named pipe (fifo). 
true if file exists and its sel-user-ID bit is set. 
true if file exists and its set-group-ID bit is set. 
true if file exists and its sticky bit is set. 
true if file exists and has a size greater than zero. 

—t [ fildes ] y 

true if the open file whose file descriptor number is fildes (1 
by default) is associated with a terminal device. 

true if the length of string si is zero, 
true if the length of the string si is non-zero, 
true if strings si and s2 are identical, 
true if strings si and s2 are not identical, 
true if si is not the null string. 

n] —cqn2 true if the integers ni and n2 are algebraically equal. Any of 
the comparisons —ne, —gt, —ge, —It. and —le may be used in 
place of — eq. 

These primaries may be combined with the following operators: 

! unary negation operator. 

—a binary and operator. 

—o binary or operator (—a has higher precedence than —o). 

( expr ) parentheses for grouping. 

Notice that all the operators and fiags are separate arguments to test. 
Notice also that parentheses are meaningful to the shell and. therefore, 
must be escaped. 


—X file 
—f file 
—d file 
—c file 
—b file 
—p file 
—u file 
-g file 
-k file 
—s file 


—z si 
—n si 
si -s2 
si \= s2 
si 
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SEE ALSO 

find(l). sh(l). 


In the second form of the command (i.e.. the one that uses []. rather 
than the word test), the square brackets must be delimited by blanks^ 
Some UNIX systems do not recognize the second form of the command. 
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NAME 

time — time a command 

SYNOPSIS . 

time command 

DESCRIPTION 

The given command is executed; after it is complete, time prints the 
elapsed time during the command, the time spent in the system, and the 
time spent in execution of the command. Times are reported in seconds. 

The times are printed on the diagnostic output stream. 

BUGS 

Elapsed time is accurate to the second, while the CPU times are meas¬ 
ured to the 50th or 60th second, dependent on the line frequency and 
the definition of HZ in /usr/sys/conf.h. Thus the sum of the CPU times 
can be up to a second larger than the elapsed time. 
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NAME 

timex — time a command; report process data and system activity 
SYNOPSIS 

timex [options] command 
DESCRIPTION 

The given command is executed; the elapsed time, user time and system 
time spent in execution are reported in seconds. Optionally process 
accounting data for the command and all its children can be listed or 

summarized, and total system activity during the execution interval can 
be reported. 

The output of timex is written on standard error. 

Options are: 

—p List process accounting records for command and all its children. 
Suboptions f, h, k, m, r, and t modify the data items reported, as 
defined in acctcom{\). The number of blocks read or written and the 
number of characters transferred are always reported. 

—o Report the total number of blocks read or written and total charac¬ 
ters transferred by command and all its children. 

s Report total system activity (not just that due to command) that 
occurred during the execution interval of command. All the data 
items listed in sar(i) are reported. 

SEE ALSO 

acctcom(l). sar(l). 

WARNING 

Process records associated v.ith command are selected from the 
accounting file /usr/adm/pacct by inference, since process genealogy is 
not available. Background processes having the same user-id, terminal- 
id, and execution time window will be spuriously included. 

EXAMPLES 

A simple example: 

timex —ops sleep 60 

A terminal session of arbitrary complexity can be measured by timing a 
sub-shell: 

timex —opskmt sh 

session commands 

EOT 
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NAME 

tk - paginator for the Tektronix 4014 
SYNOPSIS 

tk [ -t ] [ -.V ] [ -pL ] [ file ] 

DESCRIPTION 

intended for a Tektronix 4014 terminal. Tk arranges 
confnhn^^^ fit on the screen, divides the screen into Af columns, a^nd 
contributes an eight space page offset in the (default) single-column 
case. Tabs spaces, and backspaces are collected and plotted when 
necessary^ Teletype Model 37 half- and reverse-line sequences are inter- 
preted and plotted^ At the end of each page tk waits for a newline (empty 
line) from the keyboard before continuing on to the next page. In this 
wait state, the command Icommand will send the command to the shell. 

The command line options are: 

—t Don’t wait between pages; for directing output into a file. 

-V Divide the screen into N columns and wait after the last column. 


-pi 

SEE ALSO 

pr(l) 


Set page length to L lines. 
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NAME 

touch — update date last modified of a file 
SYNOPSIS 

touch [ —c ] file ... 

DESCRIPTION 

Touch attempts to set the modified date of each file. This is done by read¬ 
ing a character from the file and writing it back. 

If a file does not exist, an attempt will be made to create it unless the -c 
option is specified. 
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NAME 

tplot - graphics filters 
SYNOPSIS 


tplot [ —Tterminal [ —e raster ] ] 

DESCRIPTION 

These commands read plotting instructions (see plot(5)) from the stan- 

fZi‘7 P'-°'iuce, on the elendard output plotUn. 

instructions suitable for a particular terminal. If no ^terminal if 


300 

300S 

450 

4014 

ver 


DASI 300. 
DASI 300s. 
DASI 450. 


Tektronix 4014. 

Versatec DlSOOA. This version of plot places a scan-converted 
image in /usr/tmp/rasterSS and sends the result directly to the 
plotter device, rather than to the standard output. The -e option 

llolTer ^ scan-converted file raster to be sent to the 


FILES 


/usr/lib/t300 
/usr/lib/t300s 
/usr/lib/t450 
/usr/lib/t40l4 
/usr/lib/vplot 
/usr/tmp/rasterSS 
SEE ALSO 

plot(3X), pIot(5), term(7). 
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NAME 

tr — translate characters 
SYNOPSIS 

tr [ —cds ] [ string 1 [ stringS ] ] 

DESCRIPTION 

TV copies the standard input to the standard output with substitution or 
deletion of selected characters. Input characters found in string 1 are 
mapped into the corresponding characters of strings. When strings is 
short it is padded to the length of string 1 by duplicating its last charac¬ 
ter. Any combination of the options -cds may be used: —c complements 
the set of characters in stringl with respect to the universe of charac¬ 
ters whose ASCII codes are 01 through 0377 octal; -d deletes all input 
characters in stringl; —s squeezes all strings of repeated output charac¬ 
ters that are in strings to single characters. 

In either string the notation ct — b means a range of characters from a. to 
b in increasing ASCII order. The character ‘N ’ followed by 1. 2 or 3 octal 
digits stands for the character whose ASCII code is given by those digits. 
A ‘\ ’ followed by any other character stands for that character. 

The following example creates a list of all the words in 'filer one per line 
in 'filea', where a word is taken to be a maximal string of alphabetics. 
The second string is quoted to protect 'X ’ from the Shell. 012 is the 
ASCII code for newline. 

tr -cs A-Za-z '\012' <filel >file2 

SEE ALSO 

ed(l), ascii(7) 

BUGS 

Won’t handle ASCII NUL in stringl or stringS; always deletes NUL from 
input. 
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NAME 


trolT, nroff — typeset or format text 
SYNOPSIS 

nrofl [ options ] [ files ] 
trofi [ options ] [ files ] 
DESCRIPTION 


jVro^ formats text contained in files (standard input by default) for 
printing on typewriter-like devices and line printers; similarly, troff for¬ 
mats text for a Wang Laboratories, Inc., C/A/T phototypesetter Their 
capabilities are described in the NROFF/TROFF User's Manual cited 
below. 


—nN 

—sN 


An argument consisting of a minus (—) is taken to be a file name 
corresponding to the standard input. The options, which may appear in 
any order, but must appear before the/iZes, are; 

—olist Print only pages whose page numbers appear in the list of 
numbers and ranges, separated by commas. A range N—M 
means pages N through M', an initial —N means from the begin¬ 
ning to page N; and a final N— means from N to the end. (See 
BUGS below.) 

Number first generated page N. 

Stop every N pages. Nroff will halt after every N pages (default 
N—l) to allow paper loading or changing, and will resume upon 
receipt of a line-feed or new-line (new-lines do not work in 
pipelines, e.g., with Tnm(l)). This option does not work if the 
output of nroff is piped through coZ(l). Troff will stop the pho¬ 
totypesetter every N pages, produce a trailer to allow changing 
cassettes, and resume when the typesetter's start button is 
pressed. When nroff {troff) halts between pages, an ASCII BEL 
(in tvoff, the message page stop) is sent to the terminal. 

Set register a (which must have a one-character name) to N. 
Read standard input after/IZes are exhausted. 

Invoke the simultaneous input-output mode of the .rd request. 
Print only messages generated by .tm (terminal message) 
requests. 


—raN 
—i 

-q 

—z 


—mname Prepend to the input files the non-compacted (ASCII text) 
macro file /usr/lib/tmac/tmac.name. 

-cname Prepend to the input ;^Zes the compacted macro files 
/usr/lib/macros/cmp.[nt].[dt].nam.e and 
/usr/lib/macros/ucmp.[nt].name. 

-knamc Compact the macros used in this invocation of nroff/troff, 
placing the output in files [dtj.name in the current directory 
(see the May 1979 Addendum to the NROFF/TROFF User's 
Manual for details of compacting macro files). 


Nroff only: 

—Tname Prepare output for specified terminal. Known names are 37 
for the (default) TELETYPE* Model 37 terminal, ln300 for the GE 
TermiNet 300 (or any terminal without half-line capability), 
300s for the DASI 300s, 300 for the DASl 300, 450 for the DASl 
450, Ip for a (generic) ASCII line printer, 382 for the DTC-382. 
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4000A for the Trendala 4000A, 832 for the Anderson Jacobson 
832, X for a (generic) EBCDIC printer, and 2631 for the Hewlett 

Packard 2631 line printer. urn 

Produce equally*spaced words in adjusted lines, using the full 

resolution of the particular terminal. 

Use output tabs during horizontal spacing to speed output and 
reduce output character count. Tab settings are assumed to 
be every 8 nominal character widths. 

Set the emboldening factor (number of character overstrikes) 
for the third font position (bold) to n, or to zero if n is missing. 


TrofI only: 
-t 

-f 

—w 

-b 

—a 

—pN 

-g 


—Tname 


Direct output to the standard output instead of the photo- 

^yp0 

Refrain from feeding out paper and stopping phototypesetter 
at the end of the run. 

Wait until phototypesetter is available, if it is currently busy. 
Report whether the phototypesetter is busy or available. No 
text processing is done. 

Send a printable ASCII approximation of the results to the stan¬ 
dard output. 

Print all characters in point size N while retaining all 
prescribed spacings and motions, to reduce phototypesetter 
elapsed time. 

Prepare output for the Murray Hill Computation Center photo¬ 
typesetter and direct it to the standard output (see ycQ.i(lC)). 
This option is not compatible with the —s option; furthermore, 
when this option is invoked, all .fp (font position) requests (if 
any) in the troff input must come before the first break, and 
no .tl requests may come before the first break. 

Use font-width tables for device name (the font tables are 
found in /usr/lib/font/name/•). Currently, no names are 
supported. 


FILES 

/usr/lib/suftab 

/tmp/taS# 

/usr/lib/tmac/tmac.* 
/usr/lib/macros/* 
/usr/lib/term/ * 
/usr/lib/font/* 


suffix hyphenation tables 
temporary file 

standard macro files and pointers 
standard macro files 
terminal driving tables for nroff 
font width tables for troff 


SEE ALSO 

NROFF/TROFF User's Manual by J. F. Ossanna. 
A TROFF Tutorial by B. W. Kernighan. 
eqn(l), tbl(l), mm(7). 
col(l), greek(l), mm(l) {nroff only). 
gcat(lC), mmt(l), tc(l), mv(7) {troff only). 


Nroff/troff believes in Eastern Standard Time; as a result, depending on 
the time of the year and on your local time zone, the date that 
nroff/troff generates may be off by one day from your idea of what the 
date is. 
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When nroff/trojf is used with the -olist option inside a pipeline (e e 

cause a harmless 

in lisi^^ lagnostic if the last page of the document is not specified 
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NAME 

true, false - provide truth values 
SYNOPSIS 
true 

false 

DESCRIPTION 

TWe does nothing, successfully. False does nothing, unsuccessfully 
They are typically used m input to sh{l) such as: ^ 

while true 
do 

command 

done 

SEE ALSO 

sh(l) 

DIAGNOSTICS 

Tyne has exit status zero, false nonzero. 
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NAME 

tsort — topological sort 

SYNOPSIS 

tsort [ file ] 

DESCRIPTION 

Tsort produces on the standard output a totally ordered list of items 
consistent with a partial ordering of items mentioned in the input If 
no fiLe is specified, the standard input is understood. 

The input consists of pairs of items (nonempty strings) separated by 
blanks. Pairs of different items indicate ordering. Pairs of identical 
items indicate presence, but not ordering. 

SEE ALSO 

lorder(l) 

DIAGNOSTICS 

Odd data: there is an odd number of fields in the input file. 

BUGS 

Uses a quadratic algorithm: not worth fixing for the typical use of order¬ 
ing a library archive file. 


Page 1 


February 17,1984 
















TTY(l) 


MUNIX 


TTY(l) 


NAME 

tty — get terminal name 

SYNOPSIS 

tty 

DESCRIPTION 

Tty prints the pathname of the user’s terminal. 
DIAGNOSTICS 

‘not a tty’ if the standard input file is not a terminal. 
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NAME 

ul — do underlining 
SYNOPSIS 

ul [ -i j [ -t terminal ] [ name ... ] 

DESCRIPTION 

standard input if none are given) and 
1 *■ °f‘=^'‘ances of underscores to the sequence which indicates 
able^TERM^ for the termnal in use, as specified by the environment vari- 
ab^ TERM. The -t option overrides the terminal kind specified in the 
environment. The file /etc/termcap is read to determine the appropriate 
equences for underlining. If the terminal is incapable of underlinine 
but is capable of a standout mode then that is used instead If the termf 
nal can overstrike, or handles underlining automatically uZ degenerates 
to caZ(l). If the terminal cannot underline, underlining is ignorfd. 

The -i option causes uZ to indicate underlining onto by a separate line 

the wanf to look at 

terminal present in an nro^ output stream on a crt- 

SEE ALSO 

man(l), nroff(l), colcrt(l) 

AUTHOR 

Mark Horton 


BUGS 


backspaces and underlines intermixed 
bick».rd “tlon “"‘'^'-lining. No oUenopt io mode to optimize the 
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NAME 

umask - set file-creation mode mask 
SYNOPSIS 


umask [ ooo ] 

DESCRIPTION 

The user file-creation mode mask i*? «!pt to nnn “ru * 1 . 


If 000 is omitted, the current value of the mask is printed. 
Umask is recognized and executed by the shell. 

SEE ALSO 

chmod(l), sh(l), chmod(2), creat(2), umask(2). 
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NAME 

uname — print name of current UNIX 
SYNOPSIS 

uname [ —snrva ] 

DESCRIPTION 

r T rr,‘I-; 

options cause selected information returned by uname (2) to be prfnte^d ^ 
“S print the system name (default). 

print the nodename (the nodename may be a name that the sv^- 
tem IS known by to a communications network). ^ 

print the operating system release. 


—n 


—r 


V print the operating system version. 
~a print all the above inforrnation. 

SEE ALSO 

uname(2). 
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NAME 

unget - undo a previous get of an SCCS file 
SYNOPSIS 

unget [-rSID] [-s] [-n] files 
DESCRIPTION 

mlTte'lr^'LsVr" of - sees 

Keyletter arguments apply independently to each named file. 

-rSW Uniquely identifies which delta is no longer intended 

delta ). The use of this keyletter is necessary only if two 
or more outstanding gets for editing on the same SCCS 

® A diag¬ 

nostic results If the specified 5/D is ambiguous, or if itfs 

necessary and omitted on the command line. 

-s Suppresses the printout, on the standard output, of the 

intended delta's 5/D. 

Causes the retention of the gotten file which would nor¬ 
mally be removed from the current directory. 


—n 


SEE ALSO 

delta(l), get(l), sact(l). 
DIAGNOSTICS 

Use heLp{\) for explanations 
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NAUE 

unify relational data base system 
SYNOPSIS 

unify 

DESCRIPTION 

UNIFY is a relational data base system The UNIFY-cv«.t-n ■'<> ^ n 

The 

the UNIFY system and use the other components via menus ® 

SEE ALSO 

UNIFY - Reference Manual Version 3.0 


BUGS 


UNIFY - Tutorial Manual Version 3.0 
both copy right UNIFY Corp. 

Un!J? relatively stable. However in some applications 

UNIFY-components may run out of stack and produce a core dump In 
Igaim^^* stacksize (see stksizd)) of the program and Jy 
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NAME 

uniq - report repeated lines in a file 
SYNOPSIS 

uniq [ -udc [ +n ] [ -n ] ] [ input [ output ] ] 

DESCRIPTION 

fMtg reads the input file comparing adjacent lines. In the normal case 
the second and succeeding copies of repeated lines are removed- the 
remainder is written on the output file. Note that repeated lines muk be 
adjacent in order to be found; see sor^(i). ]f the -u flag is used, just the 
ines that are not repeated in the original file are output. The -d option 
specifies that one copy of just the repeated lines is be written ^The 
normal mode output is the union of the -u and -d mode outputs. 

des -u and -d and generates an output report in 

timSitfccur^ed 'h' "umber of 

The n arguments specify skipping an initial portion of each line in the 
comparison! 

The first n fields together with any blanks before each are 
Ignored. A field is defined as a string of non-space, non-tab char¬ 
acters separated by tabs and spaces from its neighbors. 

The first n characters are ignored. Fields are skipped before 
characters. 


—71 


+n 


SEE ALSO 

sort(l), comm(l) 
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NAME 

units — conversion program 
SYNOPSIS 

units 

DESCRIPTION 

(Mils converts quantities expressed in various standard scales to their 
equivalents m other scales^ It works Interactively in this fashion 

You have: inch 
You want: cm 

* 2.54000e^-00 
/ 3.9370le-01 

A quantity IS specified as a multiplicative combination of units optionallv 
preceded by a numeric multiplier. Powers are indicated by luflLei pile 
tive integers, division by the usual sign: ^ ^ 

You have: 15 pounds force/inS 
You want: atm 

* 1.02069e 4-00 
/9.?9?30e-0l 

LViifs only does multiplicative scale changes. Thus it can convert Kelvin 

ii'aUons'''aAd''mT*^ Centigrade to Fahrenheit. Most familiar units, abbre¬ 
viations. and metric prefixes are recognized, together with a generous 
. Jeavemng of exotica and a few constants of nature including: 

pi ratio of circumference to diameter 

c speed of light 

e charge on an electron 

6 acceleration of gravity 

force same as g 

mole Avogadro’s number 

water pressure head per unit height of water 

au astronomical unit 

•Pound’is a unit of mass. Compound names are run together, eg 'ligh- 
tyear _. British_ units that differ from their US counterparts are prefixed 
thus, brgallon . Currency is denoted 'belgiumfranc'. ‘britainpound’. ... 

For a complete list of units, ‘cat /usr/lib/units’. 


FILES 


BUGS 


/usr/lib/units 

0 

Don't base your financial plans on the currency conversions. 
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NAME 


uptime - show how long system has been up 
SYNOPSIS 

uptime 

DESCRIPTION 


FILES 


Uptime prints the current time and the length of time the system hac 
been up. It is. essentially, the first line of a w{i) command 


/Unix system name list 
SEE ALSO 
^v(l) 
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NAME 

users — compact list of users who are on the system 
SYNOPSIS 


users 


DESCRIPTION 


Users lists the login names of the users currently on the 
pact, one-line format. 


system in a com- 


FILES 

/etc/utmp 
SEE ALSO 

finger(l), who(l) 

BUGS 
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NAME 

uucp, uulog, uuname - unix to unix copy 
SYNOPSIS 

UUCP [ option ] ... source-file ... destination-file 
uulog [ option ] ... 
uuneune 
DESCRIPTION 

Uucp copies files named by the source-file arguments to the 
destination-file argument. A file name may be a path name on your 
machine, or may have the form: 

system-name!path-name 

where system-name is taken from a list of system names which uucp 
knows about. Shell metacharacters ?•[] appearing \n path-name will be 
expanded on the appropriate system. 

Path names may be one of; 

(1) a full path name; 

(2) a path name preceded by '-user where user is a login name on the 
specified system and is replaced by that user’s login directory; 

(3) a path name preceded by '-/user where user is a login name on 
the specified system and is replaced by that user’s directory 
under PUBDIR; 

(4) anything else is prefixed by the current directory. 

If the result is an erroneous path name for the remote system the copy 
will fail. If the destination-file is a directory, the last part of the source- 
file name is used. 

Uucp preserves execute permissions across the transmission and gives 
0666 read and write permissions (see chmod{2)). 

The following options are interpreted by uucp: 

—d Make all necessary directories for the file copy (default). 

—f Do not make intermediate directories for the file copy. 

—c Use the source file when copying out rather than copying the file to 
the spool directory (default). 

—C Copy the source file to the spool directory. 

—m Send mail to the requester when the copy is complete. 

—nuser 

Notify user on the remote system that a file was sent. 

—esys 

Send the uucp command to system sys to be executed there. (Note 
~ this will only be successful if the remote machine allows the uucp 
command to be executed by /usr/lib/uucp/uuxqt.) 

Uulog maintains a summary log of uucp and uux(lC) transactions in the 
file /usr/spool/uucp/LOGFILE by gathering information from partial log 
files named /usr/spool/uucp/LOG.*.?. (These files will only be created if 
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the LOGFILE is being used by another process.) It removes the partial log 
files. 

The options cause uulog to print logging information: 

—ssys 

Print information about work involving system sys. 

—uuser 

Print information about work done for the specified user. 

Uuname lists the uucp names of known systems. The —1 option returns 
the local system name. 


FILES 



/usr/spool/uucp 

spool directory 
/ usr/spool/uucppublic 

public directory for receiving and sending (PUBDIR) 

/usr/lib/uucp/ • 

other data and program files 


SEE ALSO 


mail(l). uux(lC), uuto(lC), uupick(lC). 

Lhj.cp ImpLementation Description by D. A. Nowitz. 

WARNING 

The domain of remotely accessible files can (and for obvious security 
reasons, usually should) be severely restricted. You will very likely not 
be able to fetch files by path name; ask a responsible person on the 
remote system to send them to you. For the same reasons you will prob¬ 
ably not be able to send files to arbitrary path names. As distributed, the 
remotely accessible files are those whose names begin 
/usr/spool/uucppublic (equivalent to ~nuucp or just ~). 

BUGS 


All files received by uucp will be owned by uucp. 

The —m option will only work sending files or receiving a single file. 
(Receiving multiple files specified by special shell characters ?•[] will not 
activate the —m option.) 
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NAME 

uustat — UUCP status inquiry and job control 
SYNOPSIS 

uustat [ option ] ... 


DESCRIPTION 

Uustat will display the status of, or cancel, previously specified uucp 
commands, or provide general status on uucp connections to other sys¬ 
tems. The following options are recognized: 

Twnch Report the status of accessibility of machine tnch. If mch is 
specified as all, then the status of all machines known to the 
local uucp are provided. 

—Igobn Kill the uucp request whose job number is jobn. The killed uucp 
request must belong to the person issuing the uustat command 
unless he is the super-user. 

—chour Remove the status entries which are older than hour hours. 

This administrative option can only be initiated by the user 
uucp or the super-user. 

“Uitser Report the status of all uucp requests issued by user. 

—ssys Report the status of all uucp requests which communicate with 
remote system sys. 

—ohour Report the status of all uucp requests which are older than 
hour hours. 


—yhour Report the status of all uucp requests which are younger than 
hour hours. 

—\aLl Report the status of all the uucp requests. 

—V Report the uucp status verbosely. If this option is not specified. 

a status code is printed with each uucp request. 

When no options are given, uustat outputs the status of all uucp requests 
issued by the current user. Note that only one of the options —j, —m, —k. 
—c, or the rest of other options may be specified. 


For example, the command 

uustat —uhdc —smhtsa —y72 —v 

will print the verbose status of all uucp requests that were issued by user 
hdc to communicate with system mhtsa within the last 72 hours. The 
meanings of the job request status are; 

job-number user remote-system command-time status-time status 

where the status may be either an octal number or a verbose descrip¬ 
tion. The octal code corresponds to the following description; 


OCTAL STATUS 

00001 the copy failed, but the reason cannot be determined 

00002 permission to access local file is denied 

00004 permission to access remote file is denied 

00010 bad uucp command is generated 

00020 remote system cannot create temporary file 

00040 cannot copy to remote directory 

00100 cannot copy to local directory 

00200 local system cannot create temporary file 
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00400 cannot execute uucp 
01000 copy succeeded 

02000 copy finished, job deleted 

04000 job is queued 

The meanings of the machine accessibility status are; 
system-name time status 

where time is the latest status time and status is a self-explanatory 
description of the machine status. 


FILES 


/usr/spool/uucp 


spool directory 


/usr/lib / uucp/L_stat 


system status file 



/usr/lib / uucp/R_stat 


request status file 


SEE ALSO 


uucp(lC). 

Lhistat — A UUCP Status Inquiry Program, by H. Che. 
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NAME 

uuto, uupick — public UNIX-to-UNIX file copy 
SYNOPSIS 

uuto [ options ] source-files destination 
uupick [ —s system ] 


DESCRIPTION 

Ihito sends source-files to destination. Uuto uses the uucp(lC) facility 
to send files, while it allows the local system to control the file access. A 
source-file name is a path name on your machine. Destination has the 
form: 

system.'user 

where system is taken from a list of system names that uucp knows 
about (see uuname{lC)). Logname is the login name of someone on the 
specified system. 

Two options are available: 

—p Copy the source file into the spool directory before transmission. 

—m Send mail to the sender when the copy is complete. 

The files (or sub-trees if directories are specified) are sent to PUBDIR on 
system, where PUBDIR is a public directory defined in the uucp source. 
Specifically the files are sent to 

PUBDIR/receive/us er/mysysfem/files. 


The destined recipient is notified by maiZ(l) of the arrival of files. 

Uupick accepts or rejects the files transmitted to the user. Specifically, 
uupick searches PUBDIR for files destined for the user. For each entry 
(file or directory) found, the following message is printed on the standard 
output: 

from system: [file file-name] [dir dimame] ? 

Uupick then reads a line from the standard input to determine the dispo¬ 
sition of the file: 

<new-line> Go on to next entry. 


d 

m [ dir ] 


a [ dir ] 

P 

q 

EOT (control- 


Delete the entry. 

Move the entry to named directory dir (current directory 
is default). 

Same as m except moving all the files sent from system. 
Print the content of the file. 

Stop. 

d) 


Same as q. 

\command Escape to the shell to do command. 

* Print a command summary. 

Uupick invoked with the —ssystem option will only search the PUBDIR for 
files sent from system. 
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/ 


FILES 

PUBDIR /usr/spool/uucppublic public directory 

SEE ALSO 

mail(l). uuclean(8). uucp(lC). uulog(lC). uuname(lC). 
uux(lC). 


uustat(lC). 
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NAME 

uux — Unix to Unix command execution 
SYNOPSIS 

uux [ — ] command-string 
DESCRIPTION 

Uux will gather zero or more files from various systems, execute a com¬ 
mand on a specified system and then send standard output to a file on a 
specified system. Note that, for security reasons, many installations will 
limit the list of commands executable on behalf of an incoming request 
from uux. Many sites will permit little more than the receipt of mail (see 
maif(l)) via uux. 

The command-string is made up of one or more arguments that look like 
a Shell command line, except that the command and file names may be 
prefixed by sysfem-name!. A null system-name is interpreted as the 
local system. 

File names may be one of 

(1) a full path name; 

(2) a path name preceded by ~xxx where xxx is a login name on 
the specified system and is replaced by that user's login directory: 

(3) anything else is prefixed by the current directory. 

The — option will cause the standard input to the uux command to be the 
standard input to the command-string. For example, the command 

uux "IdifT usg!/usr/dan/f 1 pwba!/a4/dan/f 1 > Ifl.diff" 

will get the fl files from the ‘'usg” and ”pwba" machines, execute a diff 
command and put the results in fl.difi in the local directory. 

Any special shell characters such as < > : j should be quoted either by 
quoting the entire command-string, or quoting the special characters as 
individual arguments. 

Uux will attempt to get all files to the execution system. For files which 
are output files, the file name must be escaped using parentheses. For 
example, the command 

uux aluucp b!/usr/file \(c!/usr/file\) 

will send a uucp command to system "a" to get /usr/file from system "b” 
and send it to system "c”. 

Uux will notify you if the requested command on the remote system was 
disallowed. The response comes by remote mail from the remote 
machine. 

FILES 

/usr/lib/uucp/spool 

spool directory 

/usr/lib/uucp/• other data and programs 
SEE ALSO 

uuclean(8), uucp(lC). 

Uucp Implementation Description by D. A. Nowitz 
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BUGS 

Only the first command of a shell pipeline may have a system-name 1. All 
other commands are executed on the system of the first command. 

The use of the shell metacharacter • will probably not do what you want 
it to do. The shell tokens << and >> are not implemented. 



February 20, 1984 


Page 2 




VAL(l) 


MUNIX 


VAL(l) 


NAME 


val - validate SCCS file 


SYNOPSIS 

val — 

val [—s] [—rSID] [—mname] [—ytype] files 
DESCRIPTION 

VaL determines if the specified file is an SCCS file meeting the charac¬ 
teristics specified by the optional argument list. Arguments to val may 
appear in any order. The arguments consist of keyletter arguments, 
which begin with a —, and named files. 

Val has a special argument. which causes reading of the standard 
input until an end-of-file condition is detected. Each line read is 
independently processed as if it were a command line argument list. 

Val generates diagnostic messages on the standard output for each com¬ 
mand line and file processed and also returns a single 8-bit code upon 
exit as described below. 

The keyletter arguments are defined as follows. The effects of any 
keyletter argument apply independently to each named file on the com¬ 
mand line. 

The presence of this argument silences the diagnostic 
message normally generated on the standard output 
for any error that is detected while processing each 
named file on a given command line. 

The argument value SID (5CCS /identification String) is 
an SCCS delta number. A check is made to determine 
if the SID is ambiguous (e. g., rl is ambiguous because 
it physically does not exist but implies 1.1, 1.2. etc. 
which may exist) or invalid (e. g.. rl.O or rl.1.0 are 
invalid because neither case can exist as a valid delta 
number). If the SID is valid and not ambiguous, a 
check is made to determine if it actually exists. 

—mname The argument value name is compared with the SCCS 

/5M% keyword in file. 

-ytype The argument value type is compared with the SCCS 

keyword in file. 

The 8“bit code returned by val is a disjunction of the possible errors, 
i. e., can be interpreted as a bit string where (moving from left to right) 
set bits are interpreted as follows; 

bit 0 = missing file argument; 

bit 1 = unknown or duplicate keyletter argument; 
bit 2 = corrupted SCCS file; 
bit 3 = can't open file or file not SCCS; 
bit 4 = SID is invalid or ambiguous; 
bit 5 = SID does not exist; 
bit 6 = %Y%, —y mismatch; 
bit 7 = %M/o. —m mismatch; 


—s 


-tSID 


O 
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Note that val can process two or more files on a given command line and 
in turn can process multiple command lines (when reading the standard 
input). In these cases an aggregate code is returned — a logical OR of the 
codes generated for each command line and file processed. 

SEE ALSO 

admin(l). delta{l). get(l). prs(l). 

DIAGNOSTICS 

Use h.elp{l) for explanations. 

BUGS 

Val can process up to 50 files on a single command line. Any number 
above 50 will produce a core dump. 
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NAME 

VC — version control 
SYNOPSIS 

VC [—a] [—t] [—cchar] [—s] [keyword=value ... keyword=valueJ 
DESCRIPTION 

The VC command copies lines from the standard input to the standard 
control of its OtTQXLTfLQTxts and coTitvoL statsTTLSTits encoun* 
tered in the standard input. In the process of performing the copy 
operation, user declared keywords may be replaced by their string value 
when they appear in plain text and/or control statements. 

The copying of lines from the standard input to the standard output is 
conditional, based on tests (in control statements) of keyword values 
specified in control statements or as vc command arguments. 

A control statement is a single line beginning with a control character, 
except as modified by the -t keyletter (see below). The default control 
character is colon (:), except as modified by the -c keyletter (see below). 
Input lines beginning with a backslash (\) followed by a control charac¬ 
ter are not control lines and are copied to the standard output with the 
backslash removed. Lines beginning with a backslash followed by a non¬ 
control character are copied in their entirety. 

A keyword is composed of 9 or less alphanumerics; the first must be 
alphabetic. A value is any ASCII string that can be created with ed(l); a 
numeric value is an unsigned string of digits. Keyword values may not 
contain blanks or tabs. 

Replacement of keywords by values is done whenever a keyword sur¬ 
rounded by control characters is encountered on a version control state¬ 
ment. The -a keyletter (see below) forces replacement of keywords in 
all lines of text. An uninterpreted control character may be included in 
a value by preceding it with \ . If a literal \ is desired, then it too must 
be preceded by \. 

Keyletter arguments 

-a Forces replacement of keywords surrounded by con¬ 

trol characters with their assigned value in all text 
lines and not just in vc statements. 

—t All characters from the beginning of a line up to and 

including the first fab character are ignored for the 
purpose of detecting a control statement. If one is 
found, all characters up to and including the fab are 
discarded. 

—cchar Specifies a control character to be used in place of :. 

—s Silences warning messages (not error) that are nor¬ 

mally printed on the diagnostic output. 

Version Control Statements 
;dcl keyword[.keyword] 

Used to declare keywords. All keywords must be declared. 
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:asg keyword=value 

Used to assign values to keywords. An asg statement overrides the 
assignment for the corresponding keyword on the vc command line 
and all previous asg's for that keyword. Keywords declared, but not 
assigned values have null values. 

;if condition 


:end 

Used to skip lines of the standard input. If the condition is true all 
lines between the if statement and the matching end statement are 
copied to the standard output. If the condition is false, all interven¬ 
ing lines are discarded, including control statements. Note that 
intervening if statements and matching end statements are recog¬ 
nized solely for the purpose of maintaining the proper if-end match¬ 
ing. 

The syntax of a condition is: 


<cond> ::= [ "not" ] <or> 

<or> ::= <and> | <and> "|" <or> 

<and> ;:= <exp> | <exp> "&" <and> 

<exp> "(" <or> ")" | <value> <op> <value> 

<op> ::= "=" I "!=" I "<" I ">" 

<value> ::= <arbitrary ASCII strihg> | <numeric string> 


The available operators and their meanings are: 

= equal 

!= not equal 

& and 

I or 

> greater than 

< less than 

( ) used for logical groupings 

not may only occur immediately after the if, and 

when present, inverts the value of the 
entire condition 


The > and < operate only on unsigned integer values (e. g.: 012 > 12 
is false). All other operators take strings as arguments (e. g.: 012 != 
12 is true). The precedence of the operators (from highest to 
lowest) is: 

= != > < all of equal precedence 
& 

I 

Parentheses may be used to alter the order of precedence. 

Values must be separated from operators or parentheses by at least 
one blank or tab. 


::text 

Used for keyword replacement on lines that are copied to the stan¬ 
dard output. The two leading control characters are removed, and 
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keywords surrounded by control characters in text are replaced by 
their value before the line is copied to the output file. This action is 
independent of the —a keyletter. 


:on 

:off 


Turn on or off keyword replacement on all lines. 

:ctl char 

Change the control character to char. 

:msg message 

Prints the given message on the diagnostic output. 

:err message 

Prints the given message followed by: 

ERROR: err statement on line ... (915) 
on the diagnostic output. Vc halts execution, and returns an exit 
code of 1. 

DIAGNOSTICS 

Use help(l) for explanations. 

EXIT CODES 

0 — normal 
1 — any error 
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NAUE 

vfontinfo — inspect and print out information about fonts 
SYNOPSIS 

yfontinfo [ — v ] fontname [ characters ] 

DESCRIPTION 

Vfontinfo allows you to examine a font in the UNIX format. It prints out 
all the information in the font header and information about every non¬ 
null (width > 0) glyph. This can be used to make sure the font is con¬ 
sistent with the format. 

The fontname argument is the name of the font you wish to inspect. It 
writes to standard output. If it can't find the file in your working direc¬ 
tory, it looks in /usr/lib/vfont (the place most of the fonts are kept). 

The characters, if given, specify certain characters to show. If omitted, 
the entire font is shown. 

If the —V (verbose) fiag is used, the bits of the glyph itself are shown as 
an array of X’s and spaces, in addition to the header information. 

SEE ALSO 

vfont(5) 

The Berkeley Font Catalog 

AUTHORS 

Mark Horton 
Andy Hertzfeld 
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NAME 

vi — screen oriented (visual) display editor based on ex 
SYNOPSIS 

vi [ —I tag ] [ —r file ] [ -^command ][—!][ —wn ] [ —x ] name ... 
DESCRIPTION 

Vi (visual) is a display oriented text editor based on an underlying line 
editor ex(l). It is possible to use the command mode of ex from within vi 
and vice-versa. 

When using vi changes you make to the file are refiected in what you see 
on your terminal screen. The position of the cursor on the screen indi¬ 
cates the position within the file. The Vi Quick Reference card and the 
Introduction to Display Editing with Vi provide full details on using vi. 

INVOCATION 

The following invocation options are interpreted by vi: 

—ttag Edit the file containing the tag and position the editor at 

its definition. 


—rfile Recover file after an editor or system crash. If file is not 

specified a list of all saved files will be printed. 


+command Begin editing by executing the specified editor search or 
positioning command . 

—1 LISP mode; indents appropriately for lisp code, the () {j [[ 

and ]] commands in vi and open are modified to have 
meaning for lisp . 

—wn Set the default window size to n. This is useful when using 

the editor over a slow speed line. 


—X 


Encryption mode; a key is prompted for allowing creation 
or editing of an encrypted file. 


The name argument indicates files to be edited. 


•'VI STATES" 

Command Normal and initial state. Other states return to command 
state upon completion. ESC (escape) is used to cancel a 
partial command. 


Insert Entered byaiAIoOcCsSR. Arbitrary text may then be 

entered. Insert is normally terminated with ESC character, 
or abnormally with interrupt. 

Last line Reading input for : / ? or !; terminate with ESC or CR to 
execute, interrupt to cancel. 

COMMANDS 

Counts before vi commands 
line/column number z G | 
scroll amount 

replicate insert a i A 1 

repeat effect most of the rest 


Sample commands 

dw 


delete a word 
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de 

... leaving white space 

dd 

delete a line 

3dd 

... 3 lines 

iieifESC 

insert text a6c 

cwneiiiESC 

change word to new 

easESC 

pluralize word 

xp 

transpose characters 

ZZ 

exit vi 

Interrupting, canceling 

ESC 

end insert or incomplete cmd 


(delete or rubout) interrupts 


reprint screen if ''? scrambles 

File manipulation 

:w 

write back changes 

:wq 

write and quit 

•q 

quit 

:q! 

quit, discard changes 

:e name 

edit file name 

:e! 

reedit, discard changes 

:e + name 

edit, starting at end 

:e +n 

edit starting at line n 

:e# 

edit alternate file 

A 

synonym for :e # 

:w name 

write file name 

:w! name 

overwrite file name 

:sh 

run shell, then return 

:\cmd 

run cmd, then return 

:n 

edit next file in arglist 

:n argrs 

specify new arglist 

:f 

show current file and line 

-G 

synonym for :f 

:ta tag 

to tag file entry tag 


:ta, following word is tag 


Positioning within file 


-F 

forward screen 


backward screen 

-D 

scroll down half screen 

-u 

scroll up half screen 

G 

goto line (end default) 

/pat 

next line matching jjaf 

?pat 

prev line matching paf 

n 

repeat last / or ? 

N 

reverse last / or ? 

/pat/-tm 

n’th line after paf 

?pat?-m 

n’th line before paf 

]] 

next section/function 

[[ 

previous section/function 

% 

find matching ( ) { or j 

Adjusting the 

screen 


clear and redraw 
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-R 

retype, eliminate @ lines 

zCR 

redraw, current at window top 

z— 

... at bottom 

z. 

... at center 

/pat/z- 

pat line at bottom 

zn. 

use n line window 

-E 

scroll window down 1 line 


scroll window up 1 line 

Marking and returning 


previous context 


... at first non-white in line 

mx 

mark position with letter x 

'X 

to mark x 

'X 

... at first non-white in line 

Line positioning 

H 

home window line 

L 

last window line 

M 

middle window line 

+ 

next line, at first non-white 

— 

previous line, at first non-white 

CR 

return, same as + ‘ 

i or j 

next line, same column 

t or k 

previous line, same column 

Character positioning 


first non white 

0 

beginning of line 

s 

end of line 

h or -* 

forward 

1 or ♦- 

backwards 

-H 

same as «- 

space 

same as -* 

fx 

find X forward 

Fx 

f backward 

tx 

upto X forward 

Tx 

back upto X 

t 

repeat last f F t or T 

t 

inverse of ; 

1 

to specified column 

% 

find matching ( ( ) or j 

Words, sentences, paragraphs 

w 

word forward 

b 

back word 

e 

end of word 

) 

to next sentence 

{ 

to next paragraph 

( 

back sentence 

( 

back paragraph 

W 

blank delimited word 

B 

back W 

E 

to end of W 
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Commands for LISP Mode 


) 

Forward s-expression 

{ 

... but don’t stop at atoms 

( 

Back s-expression 

{ 

... but don’t stop at atoms 

Corrections during insert 

-H 

erase last character 


erase last word 

erase 

your erase, same as 

kill 

your kill, erase input this line 

\ 

escapes -^H, your erase and kill 

ESC 

ends insertion, back to command 


interrupt, terminates insert 

-i) 

backtab over autoindent 

t-'D 

kill autoindent, save for next 

0-D 

... but at margin next also 


quote non-printing character 

Insert and 

replace 

a 

append after cursor 

i 

insert before 

A 

append at end of line 

1 

insert before first non-blank 

o 

open line below 

0 

open above 

TX 

replace single char with x 

R 

replace characters 

Operators (double to affect lines) 

d 

delete 

c 

change 

< 

left shift 

> 

right shift 

1 

filter through command 


indent for LISP 

y 

yank lines to buffer 

Miscellaneous operations 

c 

change rest of line 

D 

delete rest of line 

s 

substitute chars 

S 

substitute lines 

J 

join lines 

X 

delete characters 

X 

... before cursor 

Y 

yank lines 

Yank and put 

p 

put back lines 

p 

put before 

xp 

put from bufTer x 

"xy 

yank to bufTer x 

''xd 

delete into bufTer x 
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Undo, redo, retrieve 

u undo last change 

U restore current line 

repeat last change 
"dp retrieve d’th last delete 

AUTHOR 

Vi and ex are based on software developed by The Unviersity of Califor¬ 
nia, Berkeley California, Computer Science Division, Department of 
Electrical Engineering and Computer Science. 

SEE ALSO 

ex (1). "Vi Quick Reference” card and "An Introduction to Display Edit¬ 
ing with Vi", in the UNIX System Document Processing Guide. 

CAVEATS AND BUGS 

Software tabs using work only immediately after the autoindent. 

Left and right shifts on intelligent terminals don’t make use of insert and 
delete character operations in the terminal. 

The wrapmargin option can be fooled since it looks at output columns 
when blanks are typed. If a long word passes through the margin and 
onto the next line without a break, then the line won’t be broken. 

Insert/delete within a line can be slow if tabs are present on intelligent 
terminals, since the terminals need help in doing this correctly. 

Saving text on deletes in the named buffers is somewhat inefficient. 

The source command does, not work when executed as rsource; there is no 
way to use the :append, rchange, and :insert commands, since it is not 
possible to give more than one line of input to a ; escape. To use these 
on a rglobal you must Q to ex command mode, execute them, and then 
reenter the screen editor with vi or open. 
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NAME 

vsh — Visual Shell PCS Version 3.97 

SYNOPSIS 

▼sh 

DESCRIPTION 

Vsh is a highly interactive, screen oriented program which simplifies 
access to the normal Unix shell and the file system and eases many pro¬ 
gramming activities. Vsh can be used as a front-end interface to the 
Unix system for program development and normal applications Most 
commands involve only a single keystroke. There are commands in vsh 
that cause directories or text files to be displayed, editors to be called, 
compilers to be invoked, etc.. 

On entry to vsh (ie. after typing in the shell command vsh ), the user’s 
current directopr is plotted on the screen. This is called a directory 
page. The top line of the directory page displays the directory’s name. 
Each file in the directory is labeled with a letter (a through t for up to 
twenty files per page (on a normal terminal)). 

To select a file, one presses its corresponding letter. What happens after 
selection of a file depends on the nature (file type) of the file. If the file 
is a directory, vsh changes to that directory (similar to the shell com¬ 
mand cd ). For text files vsh calls the user’s default editor (set in 
his/her environment). There are several other cases for different types 
of files. Full details of this mechanism (automatic file selection) are 
given later. 

vsh displays up to twenty files at a time on a directory page. Directories 
which are larger are broken into pages of twenty-files each. The top line 
of the directory page displays the current page number and total 
number of pages in the working directory along with its name. There can 
be up to ten pages holding a total of two hundred files per directory. To 
select a page other than the current one, one can press a digit (0-9). 
Pages are numbered one through ten with 0 selecting page ten. There 
are several other commands for selecting pages (<RETURN>, for exam¬ 
ple) that are described below. In general in vsh there is more than one 
way to call the most common commands. This redundancy of command 
assignment can make it easier to learn vsh as well as simplifying the 
man-machine interface. 

A well integrated feature of Vsh is its connection between compilers and 
editors for program development. To start a compilation, one presses M. 
Vsh then calls on the Unix utility make. The output of this compilation 
from make is saved in a special file that one can later review in showfile 
mode for compile-time error messages. 

In showfile mode, vsh numbers each error message or compiler call in the 
showfile. One can select an error message by t 3 ^ing its line number. 
After selection of a line containing an error message, vsh reads the line 
trying to find a file name and a line number to call the text editor with 
the proper file at the offending line. For most normal compilers ( c, f’77 
etc...) the format of compiler error messages is standardised and vsh can 
almost always find the filename and line number. One can jump between 
the editor and the vsh error listing until one is ready for another 
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compile. 

Because Ysh is unconventional, the best way to understand how it works 
is by using it. Because Tsh is menu driven, it is hard to get lost. The 
escape mechanism to the normal shell is trivial, one only needs to type 
<SPACE> before any shell command. Beginners should find vah easier to 
learn then the conventional shell. 


FILE SELECTION 

One selects a file from the current directory page by pressing its 
corresponding letter (a through t without <RETURN>). What happens 
after selection depends on the nature of the file selected. 

File type Action upon File Selection 


Text 


Call the user’s default text editor (usually vi or med and 
set in his .profile file). Like command vi file. 


Directory 
Executable 
Object module 
Core Dump 


Change to new (sub-) directory (lower in the tree). Like 
command cd file. 

(a.out format - 411 magic number) Prompt for input and 
try to execute. Like command file. 

(•.o format - 407 magic number) Print the namelist of 
the object module. Like command nm -ng file. 

Prompt for the name of the executable file that caused 
the core dump and call default debugger (adb). Like 
command adb a.out core. 


Archive Library (ar or cpio) Print archive directory. Like command ar -vt 
file. 


Special Hie. 


Protected or 

Other Selection fails, vsh says it doesn't know what to do. 


DIRECTORY OPERATIONS 

This is a list of the directory commands. No <RETURN> is necessary after 
these commands (!!). Before doing anything else, the user should become 
familiar with commands which allow him to select files and display direc¬ 
tories. In directories larger then twenty files, the user should be able to 
display each page. 

This list contains only the main assignments of the directory commands. 
The command overview at the end of this document is a complete list of 
vsh operations and their key assignments. 


Command Action 

Q Leave vsh. Return to login shell. N.B. - vsh ignores ^c 

and as interrupts on purpose and exits only with ’Q’ 
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7 

or '‘d. 

Display help file. This describes the commands and 
options of ^1 There are several different help files for 
the different modes and pages of vsh 

a - t 

Select the corresponding file from the current directory 
page. (See automatic file selection below) 

1-9 

0 

<RETURN> 

Select page 1-9 of current working directory. 

Select page 10. 

Select next page. 

\ 

Select previous page. 

Change to parent (next-higher) directory. ( cd ../ ) 
Change to home directory. 

/ 

<SPACE> 

Change to root directory. 

Escape for one command to the normal Unix shell, vsh 
prompts for a shell command (to be ended by 
<RETURN>) and uses your default (login) shell program. 
When the shell is finished, vsh prompts for 'q* to return 
to the directory page. Whenever the prompt "Press q 
to quit" comes, vsh is just waiting in case you want to 
copy something from the screen before the directory 
page comes back. Any character typed in after this 
prompt will do. 

• 

(Comma) Escape to shell until ^z. vsh forks an interac¬ 
tive subshell. The shell prompt comes. Typing 
(Control-z) to this shell returns to the directory page. 

u - z 

User-definable extra file selectors. One can specify 6 
files for selection that may belong to any directory. 
With this mechanism one can have 6 files that are select¬ 
able from an)rwhere in the file hierarchy. 

S 

Shell environment parameter, vsh prompts with ’S’ and 
one can enter the name of any shell environment 
parameter. It will then be selected as a file. This com; 
mand means that one can put a line like 
"w=/usr/include/sys; export w;" in his/her .profile file 
and select this directory with "Sw<RETURN>". There can 


be arbitrarily many such shell parameters. 
CAPITAL-LETTER COMMANDS 

These are the basic vsh commands and its most useful features. They can 
report system status, handle files, display information and alter the 
environment of vsh. 

Many commands ask (prompt) for input, a file name, for example. When 
typing these responses in, just as in the normal shell, typing <BACK- 
SPACE> erases the last character typed in and typing ’'‘x’ erases the 
entire input line. Typing <RETURN> ends the response to these prompts. 
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Instead of a filename one can also type in a single lower-case letter (’a’ 
through 't') to select a file from the current directory page. For those 
commands that present a list (menu) of possible selections. ’C’ for exam¬ 
ple but not ’R*. the action is carried out immediately - no <RETURN> is 
necessary!! 

These are convenience commands. 

H (Help) vsh asks for a help subject and prints (using the internal 

paginator described below) the help file for that command, 
option or language. This uses the utility help. 

I (display) vsh prompts for a file and displays it as ascii text. This 

is faster than a selection which calls the editor. Answer the 
prompt either with a filename or with a single character for 
selection from the current directory page. (N.B. This makes it 
hard to use vsh in directories with files that have single¬ 
character filenames.). The format is the same as that of the pg 
(1) program (see below). 

D (Date) Display date and time on line 24 of the screen. 

P (Process status) Call /bin/ps. Report active processes. 

W (Who) Display who is logged in. 

X (eXpr) Evaluate a mathematical expression. This is like a pocket 

calculator, vsh prompts for an expression’ in the format of the 
math utility and prints the answer if the evaluation succeeds. 
Normal operators are +, •, /, % (modulo), ^ (to the power of), 

sin(), cos(). atan(), ln(), exp(), fioor(). absQ. rand() (returns a 
random number between zero and its argument) and 
parentheses can be used. 

These are advanced commands. 

F (Rle) Select file by name, vsh prompts for a file name and then 

selects the specified file (which need not be on the current 
directory page). This is useful for selecting directories to per¬ 
form cd to somewhere far away (ie. where it is faster to type the 
complete file name in than it is to use ’\’ and file selection to 
get there). 

V (Vi) Select a text file for editing, vsh prompts for a file name 

and calls the default text editor on that file. This works even if 
you change the vsh default action for the selection of a text file 
(which is normally to call the editor). For browsing one often 
changes this to more or pg. 

C (Create) Create a new file, vsh prompts for a file name and 

shows a menu of file types (Text, Directory, Data, Copy, Link or 
Move). One may create text files (with the editor), directories 
(with mkdir ) or empty data files (on which zeroes will be writ¬ 
ten with a given format and size). One may also copy, link and 
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move from existing files. 

L (1» -I) Long format file listing. Next to each file, vah displays 

protection information (access rights), alteration date and file 
size in the same manner as 11 or Is -1. 

K Long format listing. Next to each file vsh prints its idea of the 

file’s type in the same manner as file. This is much slower than 
'L' because vsh has to open and read something from the begin¬ 
ning of each file to be able to determine its type. 

O (Options) The contents of command and parameter tables are 

displayed. These control the assignments of capital-letters to 
functions as well as the file selection actions and help cards, 
▼sh prompts for input lines which modify parameters or which 
create, modify or delete commands. Almost all of the com¬ 
mands and functions listed here are interactively alterable 
and users can save their personalised vsh environments in their 
SSAVE/.vshrc or SHOME/.vshrc files for automatic loading upon 
entry. Typing q<REnrRN> in Options Mode returns to the direc¬ 
tory page. 

T (Touch) vsh prompts for a file name and 'touches’ the file. This 

updates the file’s date of last alteration for programs that care 
or that select the newest file in a directory. 

INTERNAL PAGINATOR 

The commands ’I’ and ’H’ use a simple paginator just like the one called 
pg (l). It displays text files one terminal screen at a time and waits for 
user input after each page. The last line of the screen is a prompt for 
user input. 

The commands are f (forwards) to display the next page of the file, d 
(down) to display the next half-page, b (back) to redisplay the first page 
and q (quit) to return to the vsh directory page. <RETURN> means the 
same as ’f’. 

REMOVE MODE 

Press ’R’ to enter Remove mode. 

In Remove mode, selecting a file causes it to be marked for removal with 
two slashes, "//" next to its file selection letter. Files selected a second 
time are unmarked (they toggle, that is). 

Pressing R a second time causes all marked files to be removed. The fol¬ 
lowing commands are available in Remove mode: 

Command Action 


<Relum> Exit Remove mode without removing marked files. 

Same as <Retum> 

a - t Select corresponding file for removal, (toggle switch) 
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Select all files on current page for removal. 

Select and display another page. These commands are 
described earlier in the manual in the section on direc¬ 
tory operations. Files selected for removal on one page 
are not forgotten by moving to another page. The other 
page selection commands discussed as directory opera¬ 
tions are also available. These include ’+’ and 

but not <RETURN>. 

Display help file for Remove mode. 

Remove all marked files on all pages and exit remove 
mode. If vsh cannot remove a file, it displays the reason 
and waits for a response. Press <Return> to continue 
removing marked files. Press to immediately exit 
from Remove mode. 

HAKE. GREP. AND SHOWFILE 

With its interfaces to make and grep, vsh saves output messages (stdout 
and stderr) from these programs and allows one to examine the results 
in Showfile mode. From the directory page, the following commands con¬ 
trol make , grep t and showfile mode. 

Q (grep) vsh prompts for a pattern and file names, and then runs 

grep in the background with these parameters, grep searches 
for the given text pattern in all listed files and reports each 
occurance with the file name and line number. The results are 
saved in the file ’.grepouf in the current directory and vsh 
beeps the terminal’s bell when finished. 

S (show) previous grep. The output of the last grep run (the file 

’.grepout’) is displayed in Showfile mode. Showfile mode com¬ 
mands are described below. 

U (make) vsh prompts for a target file (ie. the name of an entry in 

the makefile) and runs make. Execution is controlled by the 
makefile in the current directory. Output (messages from make 
and/or programs called from the make process) is both 
displayed on the screen and saved in the file ’.output.’ When 
make terminates, vsh enters Showfile mode with the file ’.out¬ 
put’. 

N Make running in the background, make is run but vsh does not 

wait for termination. Output is saved in ’.output', but is not 
displayed on the screen. When make terminates, the bell on 
your terminal rings twice. Use the E command to review the 
output in ’.output’. 

E (errors) The results of the last make (in file ’.output’) are 

displayed in Showfile mode. 

SHOWFILE MODE 

Showfile mode displays the results of the execution of make or grep. It is 
called by the ’E’ and ’S’ commands or automatically in the course of an 
’M’ command. 
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Showfile mode is essentially a special editor, it displays a selected file 
with the lines numbered. It has commands which allow one to display 
specific portions of the file. One cannot alter the file being displayed but 
can command showfile to read and parse a line of the file. It then scans 
this line and attempts to extract a file name and line number and then 
calls the editor, starting it at the specified line. The format of the error 
messages from most compilers is simple for the showfile mode parser to 
decode. Take for example this message from the C compiler about the file 
’expr.c’ 

c9:e>(pr.c:105: eteck undefined; func. expr 


Selecting this line from a showfile page would call the editor with the file 
expr.c at line 105. 

These are the showfile commands. It is not necessary to press <Return> 
after these commands. When a complete command is sensed, it is run 
immediately. 

Command Action 



~<RETURN> 


(for a line number) Print error file starting at 
specified line. 

Examine error line for a file name and line number. 
If they are found, run the editor on this file at the 
specified line, vsh can find (with relatively good accu¬ 
racy) file names and line numbers for error messages 
from the c. pascal and t77 compilers, grep messages and 
shell command errors. 

Same as ~e 


<RETirRN> 

q 

-d 

7 


Display the next twenty lines. 

Leave Showfile Mode. Return to directory page. 
Same as q 

Display help file for Showfile mode. 


All commands from the directory page which might be useful are avail¬ 
able in Showfile mode. They include :, /, „ ., and ’A’ through ’Z’ except ’L’, 
•K* and ’R*. 

Particularly useful are ’M’ and ‘G’ which allow new iterations of make and 
grep, the escapes to the shell, and T’ and ’V’, which allow one to edit files 
not found in the the error message file being shown. 


MENU MODE 

Vsh also offers a mode called menu mode which is like showfile mode 
except that the messages that are displayed are not error messages but 
shell commands with prompts and comments to explain their effects. 
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Menu mode can be entered with ’A’ and looks for a file named ’.menu’ in 
the current directory or the user’s home directory. ’This file should be a 
list of shell commands with or without prompts and comments. Typical 
menu mode lines might look like: 

uhereis S; where!8 the binary & doc for this command 
uc S; word count of the contents of an ascii file 

set; show settings of she11 parameters 

One can see the format of these entries. The shell command, exactly as 
you would have typed it in comes first. If menu mode is to prompt for 
parameters or completion of the command, a ’S’ must appear in the 
menu line where the prompted-for parameter is to be. After the com¬ 
mand, there can be a ’;’ and the rest of the menu line will be ignored, it 
can be used for comments, help, explaination, etc.. 

To use menu mode, one just has to enter it (normally with ’A’) and select 
a line number from the current screen. If the selected line contains a ’S’, 
menu mode will prompt with the command part of the line and wait to 
read typed in input (until <RETURN>). Command lines without parame¬ 
ters (ie. without ’S’), are executed immediately. 

CONTROL COMMANDS 

The operation of vsh is controled by its parameter and command tables. 
The contents of these tables can be displayed and altered with the ’6’ 
command. When vsh is invoked, it searches for the file named ’.vshrc’ in 
your save or home directorys (defines by the shell parameters SSAVE and 
SHOME). Control comands are then read from this file, allowing one to 
create a personalized environment. 

The ’0’ command also prompts for control parameters, allowing for 
interactive modification of the tables. These control parameters should 
be presented in the same lexical grammar as shell commands. Spaces 
and tabs separate tokens. Unquoted newlines terminate each statement. 

A character may be quoted by preceding it with a \. All* characters 
inside single quotes (’ ’) are quoted except the single quote. Inside dou¬ 
ble quotes (" "), \ quotes another double quote and \ newline is ignored. 
Grave accents (’ ’) are treated as any other character. Macros (such as 
SHOME) are not available in Options mode. 

The lexical grammar is compatible with that of the normal Unix shell. 
The grammar is somewhat different from that of csh. The file Misc/.vshrc 
in the vsh source directory contains default parameters. 

To change a parameter, type it in the format of its line in the Options 
listing, that is: 

PARAMETER-NAME PARAMETER-VALUE 
where PARAMETER—NAME can be any off the following: 

Parameter Usage 

editor Preferred editor. Loaded from shell environment param¬ 

eter SEDITOR or set in ’.vshrc’. See .profile. 
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make 

make program. Default is Vbin/make’. 

erep 

makeiTor 

grepout 

Tshhelp 

grep program. Default is '/bin/grep'. 

output file for make. Default is ’.output’. 

output file for grep. Default is ’.grepout’. 

Help card for ’?’ command. Default is 

’/usr/lib/vsh/vshhelp’. There is also a german version 
in ’/usr/src/local/help/vsh’. 

rmhelp 

showhelp 

pghelp 

debugger 

help 

ffile 

Help card for ’?’ in remove mode. 

Help card for ’?’ in showfile mode. 

Help card for ’?’ in display mode. 

Debugger program. Default is ’/bin/adb’. 

Help program. Default is ’/usr/local/help’. 

File-type program for command ’K’. Default is 
’/usr/lib/vsh/ffile’ (a modified version of ’file’ that 
doesn’t print the newline after the file type). 

ar 

cpio 

who 

Library archiver program. Default is ’/bin/ar’. 

Tape format library program. Default is ’/bin/cpio’. 

Who program. Default is ’/bin/who’. 

ps 

bsh 

Process status program. Default is ’/bin/ps’. 

Bourne shell. Default is ’/bin/sh’. (Shell parameter 
8SHELL) 

csh 

root 

math 

Cshell. Default is ’/usr/ucb/csh’. 

Root of the user’s file system. Default is ’/’. 

Mathematical expression evaluator. Default is 

’/usr/local/math’. (From F.R.Moore at C.A.R.L. at C.M.E. 
at U.C.S.D.) 

u - z 

File names for 6 extra selectable files. The user can 
assign these in his .vshrc file and access them thereafter 
with single keystrokes. They are assigned default values 
by vsh. 


To define a command, use the format: 

CHARACTER KEYWORD [PARAMSTERS...] 
where CHARACTER is the character which calls the new command. 

Valid characters are A-Z and !'*# S %&*():• = ^ ~ [] H <>./ ? 

These are the valid keywords. They correspond to internal functions in 
Tsh 
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Keyword 

Purpose 

date 

ahowerror 

showgrep 

showznenu 

fUe 

Display date. Usually 'D*. 

Show errors from previous make. Usually 

Show output from previous grep. Usually 'S’. 

Show menu from file ’.menu’. Usually ’A’. 

Select a file. If parameter is present, the parameter is 
selected using the normal criteria for automatic file 
selection. Otherwise, vsh will prompt for a file name. 
Usually ’F’. 

home 

Change to home directory. Usually ’:’ (often also 
assigned to ’!’ in the .vshrc file.) 

grep 

wmake 

Run grep. vsh will prompt for parameters. Usually ’G’. 

Run make. Wait for termination and enter Showfile 
mode. Usually ’M*. 

fmake 

Run make. Do not wait for termination. Usually ’N’. 

remove 

longlist 

Enter Remove mode. Usually ’R’. 

Print long format listing of files on the current page. 
Usually ’L’. 

klonglist 

Print long formal listing with file type on the current 
page. Usually ’K’. 

create 

vsh Enter Create Mode. Create mode has its own menu of 
file types. Usually ’C’. 

dollar 

Prompt with ’S’ and read a shell parameter for file selec¬ 
tion. Usually ’S’ and ’.’. 

display 

Display the contents of a file. If no parameter is 
present, vsh will prompt for a file name. This is the vsh 
internal version of the pg command as described above. 
Usually ’!’. 

options 

Display vsh options (parameter and command tables). 
Accept commands which modify parameters and which 
create, modify, and delete commands. If options is 
called with an argument, it will vrrite the current con¬ 
tents on a file named ’.vshrc.new’ and EXIT IMMEDIATELY 
to allow the user to re-enter with the new init. file. 
Between exiting and re-entering, the user should move 
(with mv for example) the ’.vshrc.new’ file to ’.vshrc’ 
(after possibly saving the old copy). With this each user 
can save his vsh environment in his own initialisation 
file. He only has to set a capital letter to ’options xxx’ 
with options mode and then call this letter. It is good to 
edit the ’.vshrc.new’ file before re-entering to remove 
this setting. Usually ’O’. 

exec 

Execute a program directly with the exec system call. 
The first parameter must be the program name. 
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prexec 


callshell 


vhelp 


▼ersion 

callcshell 

null 


Directories in the user’s default parameter SPATH are 
successively searched as in the shell. Any other param¬ 
eters become parameters to the program. If it is neces¬ 
sary to search several directories for programs, to 
redirect files, to expand macros, or to expand file regu¬ 
lar expressions, use the callshell keyword instead. 

Prompt for input and run a command. The prexec 
(prompt exec) function takes 3 parameters: 

[1] the prompt that it should print, 

[2] the pathname (full or not) of the program it should 
execute and 

[3] the character ’g’ if prexec should wait for <RETURN> 
when the command is finished before returning to the 
directory page otherwise some other character other 
than ’c’ which is used for prompting shells.. 

If the prompt is to contain spaces (ie. if it has more than 
one word), you must enclose it in quotes ("..."). 

If no parameter is present, an interactive shell is 
spawned. If one parameter is present, it is passed to the 
shell and run as a command. Do not specify more than 
one parameter. Instead, enclose the entire shell com¬ 
mand in quotes to provide vsh with only one parameter. 
Usually • ’. 

Display the help card for vsh. Usually ’?' from the direc¬ 
tory page. 

Tell which version of vsh you are using. Usually 
Like callshell only it calls the Cshell. 

Delete command. The command will no longer be active. 


DISPLAY PARAMETERS 

vsh has several switches that control the display of the directory page. 

These are different from parameters and keywords in that they have a 

specific set of possible values that are listed below. 

Uist This switch can be set with values ’on’ or ’off’ and controls the 
display of the directory page. With Hist ’on’, vsh will display 
filenames in the format of the If command, that is, there can be 
a character after the filename that denotes the file type. Direc¬ 
tories are followed by ’/’, executable files by ’•’, named pipes by 
’-’ and special files by Other file types are not noted. This 
option makes the directory display somewhat slower. 

tiist Normally vsh sorts directories alphabetically by name. When 
switch Uist is set ’on’ they will be sorted as with the Is -t com¬ 
mand, that is by date of reference with the most recently refer¬ 
enced files comong first. This switch can also only take the 
values ’on’ and ’off’. 

ncol vsh can display up to 3 directory columns (up to 60 files) on one 
directory page. The switch ncol (number of columns) can be set 
to 1, 2 or 3 to alter this attribute. Note that only files from the 
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first (left-most) column can be selected and that successive 
columns are referenced with page number and selection letter. 

prompt This switch (when 'on’) will cause vsh to display a prompt for file 
selection (or ? for help) on each directory page. 

ENVIRONMENT PARAMETERS 

vsh takes the following parameters from the global environment: 


HOME 

The home directory. This parameter is automatically set 
by Unix when one logs in. 

SAVE 

The directory to search for ’.vshrc’. If SSAVE is not set, 
vsh will search in SHOME. It is recommended that users 
define SSAVE as someting like ’SHOME/.save’ and move 
.profile, .vshrc, .cshrc, etc. there. 

SHELL 

The users login shell. Unix also sets this parameter. 
?fhen it is necessary to escape to a shell, this parameter 
selects the program to use. 

TERM 

The terminal type. The terminal must be cursor 
addressable. The initialisation phase of vsh will use this 
to get the right cursor-positioning commands to work on 
your current terminal so this better be the terminal 
type you’re really at! 


See the Termcap documentation for more information about the TERM 
parameter. Other exported shell parameters can be read by vsh for 
automatic file selection with 'S’ or as described above. 


MAIL The user’s mail file name, usually /usr/mail/user_name. vsh 
checks if there is new mail upon each return from a subprocess 
and will print the message "you have mail" if there is. 


FILES 

These are the files vsh needs and/or uses. 

SSAVE/.vshrc (or SHOME/.vshrc) Initialization file (optional). 

/etc/termcap Terminal capability database necessary for addressing 
cursor. 


.output 

.grepout 


.menu 


/dev/null 


File used to save the output of make. This file is always 
created in the current directory. 

File used to save the output of grep. vsh tries to first 
create this file in the working directory. If unsuccessful, 
the home directory is tried. 

File used for menu mode text. This is also first searched 
for in the current directory, then in the user’s home 
directory. 

Null file. 


vsh also calls the user’s default shell, editor, make, grep, ffile, help, 
math... 
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EXAMPLE of a ‘.vBhrc* file 

This is an example of an initialisation file for vsh. It sets the characters 
u through z and reassigns several Capital Letters. After calling vsh I can 
perform cd /usr/src/local/win/lib with y or rm core with B. Note also 
that redundant assignments are possible (ie. ! is now the same as :) and 
that (as in P) arguments to commands are possible. 


u fl te 

V file 
u file 
X file 
U fi le 
z file 
B exec 
J exec 
P exec 
T prexec "uherei 8 

Y exec /bin/df 

Z exec /bin/mail 
! home 
editor 
grep 
I Iist on 
ncol 1 


/uer 

/usr/sar/stp/net 
/usr/incIude/eys 
/usr/src/1 ocaI 
/usr/src/1 ocaI/uin/1ib 
/usr/src/1 ocaI/buch 
/bin/rm core 
/usr/bin/readneus 
/bin/ps a 


/usr/ucb/uhereis 


/usr/ucb/vi 
/bin/egrep 



The default settings for u through z are: 

u file /uer 

V file /etc 

u file /usr/include 

X file /lib 

y file /usr/lib 

z file /usr/src 

As mentioned above, one can also place lines like: 

Ib/ust/ include; export i; 

in his/her ’.profile’ file and later select this file with ’8i<RETURN>’. 


Authors 

The history of vsh is indeed colorful. This version is based on the so- 
called ’visual interpreter’ that was written by Dave Scheibelhut as part of 
his thesis at U.C.Berkeley in about 1978. It was distributed as part of 
UCB’s 2.8 BSD PDP-11 Unix tape but later discontinued because of bugs 
and design problems it contained. This version was stripped down, fixed 
and ported to a PDP-11 at CMRS at the University of Salzburg by Stephen 
Pope and further there developed between 1980 and 1983. Version 4.0 
was brought onto the PCS Machines and Munix 1.5 System V by STP and 
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Dittmar Krall at PCS GmbH n Munich. Germany. 

BUGS 

Vsh has no bugs or inconsistencies -whatsoever. 

It can get confused, however, by inappropriate input or by t)rping lots 
when it expects a little (ie. typing shell commands in without preceding 
them with <SPACE>). When this happens, typing -C or <BREAK> will 
clear the input stream and restore some degree of order. 

In directories with more than 200 files, -vsh ignores files after the 200th. 
This means the 200th in the unsorted directory list, not necessarily the 
last alphabetically. 

SEE ALSO 

Unix Programmers’ Manual - Vol 1 - pg(l) 

Unix Programmers’ Manual - Vol 1 - sh(l) 

• Unix Programmers’ Manual - Vol 1 - csh(l) 

Unix Programmers’ Manual • Vol 1 * termcap(3) 

Unix Programmers’ Manual - Vol 1 - curses(3) 

Handbuch fuer das Unix Betriebssystem 

Stephen T. Pope. CMRS / PCS. 1903 

Chapter 0 is a long tutorial for vsh (in German). 

Introduction to the Mshell. 

Notes on Using the Mshell & 
vsh/msh Version 3.0 Distribution Notes 
Stephen T. Pope. CMRS. 

Cooperative fuer Computermusik. 

Universitaet Salzburg. 1901*83 
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COUMAND SUliUARY 

This is a copy of the vsh help card for the directory page. 


•> Vshell - Command Summary pag^ 1 of 4 

Directory Page Commands - No d^TURN> necessary 
Command Action 


Q or -d - Leave Vsh (’Q* or control-d) - return to login shell 

? - Display this help card - 4 pages - use format of *1* or pg 

a to t - Select associated file from directory page by letter 

File selection possibilities described on page 3. 

1-9, 0- Select page 1-3 uithin current directory. 0 selects page 10. 

- or * - Select previous page 

4 - or ; - Select next page 

•<PETURN>- Select next page 

<5PACE> - Execute temporary shell - return to vsh after 1 command 

, or Execute shell - to return to vsh. type 'Z to shell 

: or Change to Home directory 

\ or 1 - Change to previous (parent) directory. 

/ - Change to root directory 

Capital Letter Commands - No <flETURN> necessary page 2 of 4 


Command 


Action 


A 

C 

D 

E 

F 

G 

H 

I 

K 

L 

n 


0 

p 

R 


- enter shoufile mode 
prompt for name S type 


Shou menu of She I I commands 
Create file or directory - 
Date and time 

Shou Errors from previous make - enter shoufile mode 

read file .output in current directory 
File selection by name - prompt for name 

Grep - search for a pattern - prompt for pattern & files 

write file .grepout 

Help - paginate online heipcard - prompt for subject 
Display file (text) - prompt for name or letter 

use internal paginator like pg 
Long listing - gives file type like the shell command ’file* 
Long listing - gives date of alteration like II 
Make - read makefile - prompt for entry’s name 

urite .output - enter shoufile mode 
Make in back^yound (forked off) - prompt for entry’s name 

write .output - beep uhen finished 
Options ' enter option mode 

Process status - cal I ps 

Remove files - enter remove mode 
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Hore Capital Letter Commands - No ^£TURN> 


page 3 of 4 


S 

T 

U 

V 

U 

X 


Show output of Grep - enter showfile mode 

read file . 0 *epout 

Touch - i 4 )dato a file - prompt for name or letter 

Print file - call Ipr - prompt for name or letter 

edit (vl or med) - prompt for name or letter 

Who Is Iogged on - call who 

Evaluate mathematical expression- prompt for expression 


File Selection 

occurs automatically upon pressing a selection letter In the current dir. 


File typo selected - Action taken by vsh 


Text 

Executable 

Directory 
Archive 
Core dump 
Other 


Execute editor on file, (vl or med) 

Exiting the editor returns to the same page. 
Prompt for input (argv) and execute file. (a.out) 
Interactive pro^ams take over the terminal. 
Change to louer (sub-) directory, (cd) 

List contents of archive, ar or cpio format, (ar vt) 
Prompt for object file S debug dump, (adb core) 
Return error message 


Other Vsh Pages 

have their own help cards viewable with ’?’ 


page 4 of 4 
from uithin each page. 


Display Page - Use *1’ for internal paginator - like pg 

Commands: f - (forwards) - display next 21 lines of file 

<JRETURN>- same as ’ f’ 
d - (down) - display next 15 lines 

b - (back) - go to start of file 

q - (quit) - return to directory page 


Showfile Page - Use ’E’ or ’S’ to enter showfile mode for make or jrep 

Commands: - (edit) search line for a fi le name and 

lino number, then call editor to that point 
'-«^^TURN>- same as ^ 

- (print) print showfile starting at line ’~* 
q - (quit) - return to directory page 
Display mode commands (b,d,f) work in Showfile mode 


Remove Page - Use ’R’ then select files a through t (or *) from any page. 
Press ’R’ a second time to perform removal. 


Options Page - Use ’0’ to view or set vsh internal parameters. 

To change one, just type its name and new value, then 
<fiETURN>» Typo q<flETURN> to return to directory page. 

Menu Page - Use ’A’ to enter menu mode - select comands from the menu 
with their lino numbers. This is akin to Showfile mode. 
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NAME 

w — who is on and what they are doing 
SYNOPSIS 

w [ —h ] [ “S ] [ user ] 

DESCRIPTION 

W prints a summary of the current activity on the system, including what 
each user is doing. The heading line shows the current time of day, how 
long the system has been up, the number of users logged into the system, 
and the load averages. The load average numbers give the number of 
jobs in the run queue averaged over 1, 5 and 15 minutes. 

The fields output are; the users login name, the name of the tty the user 
is on, the time of day the user logged on. the number of minutes since 
the user last typed anything, the CPU time used by all processes and 
their children on that- terminal, the CPU time used by the currently 
active processes, the name and arguments of the current process. 

The —h flag suppresses the heading. The —s flag asks for a short form of 
output. In the short form, the tty is abbreviated, the login time and cpu 
times are left off, as are the arguments to commands. —1 gives the long 
output, which is the default. 

If a user name is included, the output will be restricted to that user. 

FILES 

/etc/utmp 

/dev/kmem 

/dev/drum 

SEE ALSO 

who(l), finger(l). ps(l) 

AUTHOR 

Mark Horton 

BUGS 

The notion of the "current process" is muddy. The current algorithm is 
"the highest numbered process on the terminal that is not ignoring 
interrupts, or, if there is none, the highest numbered process on the ter¬ 
minal". This fails, for example, in critical sections of programs like the 
shell and editor, or when faulty programs running in the background 
fork and fail to ignore interrupts. (In cases where no process can be 
found, w prints 

The CPU time is only an estimate, in particular, if someone leaves a back¬ 
ground process running after logging out. the person currently on that 
terminal is “charged” with the time. 

Background processes are not shown, even though they account for 
much of the load on the system. 

Sometimes processes, typically those in the background, are printed with 
null or garbaged arguments. In these cases, the name of the command is 
printed in parentheses. 

W does not know about the new conventions for detection of background 
jobs. It will sometimes find a background job instead of the right one. 
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NAME 

wait — await completion of process 

SYNOPSIS 

wail 

DESCRIPTION 

Wait until all processes started with & have completed, and report on 
abnormal terminations. 

Because the waitiZ) system call must be executed in the parent process, 
the Shell itself executes wait, without creating a new process. 

SEE ALSO 

sh(l) 

BUGS 

Not all the processes of a 3- or more-stage pipeline are children of the 
Shell, and thus can't be waited for. 
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NAME 

wc — word count 
SYNOPSIS 

wc [ —Iwc ] [ name ... ] 

DESCRIPTION 

Wc counts lines, words and characters in the named files, or in the stan¬ 
dard input if no name appears. A word is a maximal string of characters 
delimited by spaces, tabs or newlines. 

If the optional argument is present, just the specified counts (lines, 
words or characters) are selected by the letters 1, w, or c. 
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NAME 


what — identify SCCS files 

SYNOPSIS 

what files 

DESCRIPTION 

What searches the given files for all occurrences of the pattern that 
substitutes for %Z% (this is @(#) at this printing) and prints out 
what follows until the first ", >. new-line. \, or null character. For exam¬ 
ple. if the C program in file f.c contains 

char ident[] = "@(#)identification information"; 
and f.c is compiled to yield f.o and a.oul. then the command 
what f.c f.o a.out 
will print 



f.c: 


identification information 
f.o: 

identification information 

a.out: 

identification information 

What is intended to be used in conjunction with the command get{l), 
which automatically inserts identifying information, but it can also be 
used where the information is inserted manually. 

SEE ALSO 

get(l). help(l). 

DIAGNOSTICS 

Use help{\) for explanations. 

BUGS , . , , , 

It’s possible that an unintended occurrence of the pattern @(#) could be 
found just by chance, but this causes no harm in nearly all cases. 



o 


Page 1 


February 20, 1984 










WHATIS(l) 


MUNIX 


WHATIS (1) 


NAME 

whatis — describe what a command is 
SYNOPSIS 

whatis command ... 

DESCRIPTION 

hTiatis looks up a given command and gives the header line from the 
manual section. You can then run the Tnan(l) command to get more 
information. If the line starts •name(section) ...' you can do ‘man section 
name’ to get the documentation for it. Try ‘whatis ed’ and then you 
should do ’man 1 ed’ to get the manual. 

HTiatis is actually just the —f option to the man(l) command. 

FILES 

/usr/lib/whatis Data base 
SEE ALSO 

apropos(l), man(l), catman(8) 

AUTHOR 

William Joy 
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NAME 

whereis — locate source, binary, and or manual for program 
SYNOPSIS 

whereis [ —sbm ] [ —u ] [ —SBM dir ... —f ] name ... 

DESCRIPTION 

Whereis locates source/binary and manuals sections for specified files. 
The supplied names are first stripped of leading pathname components 
and any (single) trailing extension of the form ".ext”, e.g. ".c”. Prefixes 
of "s.” resulting from use of source code control are also dealt with. 
Whereis then attempts to locate the desired program in a list of standard 
, places. 

You can change this list of standard places. There is a file 
"/usr/lib/whereis.dirs" which you can edit. Beware of the special line 
format used there. 

If any of the —b, —s or —m flags are given then whereis searches only for 
binaries, sources or manual sections respectively (or any two thereof). 
The —u flag may be used to search for unusual entries. A file is said to be 
unusual if it does not have one entry of each requested type. Thus 
"whereis -m -u •” asks for those files in the current directory which have 
no documentation. 

Finally, the —B —M and —S flags may be used to change or otherwise limit 
the places where whereis searches. The xB -f file flags is used to ter¬ 
minate the last such directory list and signal the start of file names. 

EXAMPLE 

The following finds all the files in /usr/bin which are not documented in 
/usr/man/manl with source in /usr/src/cmd: 

cd /usr/ucb 

whereis —u —M /usr/man/manl —S /usr/src/cmd —f ♦ 

FILES 

/usr/src/* 

/usr/|doc,manj /• 

/usr/lib/whereis.dirs 

/lib, /etc, /usr/(lib,bin.ucb,old,new.localj 

AUTHOR 

William Joy 

BUGS 

Since the program uses chdir{2) to run faster, pathnames given with the 
~M —S and —B must be full; i.e. they must begin with a "/■■. 
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NAME 

which — locate a program file including aliases and paths {csh only) 

SYNOPSIS 

which [ name ] ... 

DESCRIPTION 

Which takes a list of names and looks for the files which would be exe¬ 
cuted had these names been given as commands. Each argument is 
expanded if it is aliased, and searched for along the user's path. Both 
aliases and path are taken from the user’s .cshrc file. 

FILES 

~/.cshrc source of aliases and path values 
DIAGNOSTICS 

A diagnostic is given for names which are aliased to more than a single 
word, or if an executable file with the argument name was not found in 
the path. 

BUGS 

Only aliases and paths from ~/.cshrc are used, importing from the 
current environment is not attempted. Must be executed by a csh. since 
only csh's know about aliases. 
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NAME 

who — who is on the system 
SYNOPSIS 

who [ —uTlpdbrtas ] [ file ] 
who am i 
DESCRIPTION 

Who can list the user's name, terminal line, login time, elapsed time since 
activity occurred on the line, and the process-lD of the command inter¬ 
preter (shell) for each current UNIX System user. It examines the 
/etc/utmp file to obtain its information. If file is given, that file is exam¬ 
ined. Usually, file will be /etc/wtmp, which contains a history of all the 
logins since the file was last created. 

Who with the am i option identifies the invoking user. 

Except for the default —s option, the general format for output entries is: 

name [state] line time activity pid [comment] [exit] 

With options, who can list logins, logoffs, reboots, and changes to the sys¬ 
tem clock, as well as other processes spawned by the init process. These 
options are; 

—u This option lists information about those users who are currently 
logged in. The name is the user's login name. The line is the name 
of the line as found in the directory /dev. The time is the time that 
the user logged in. The activity is the number of hours and 
minutes since activity last occurred on that particular line. A dot 
(.) indicates that the terminal has seen activity in the last minute 
and is therefore "current". If more than twenty-four hours have 
elapsed or the line has not been used since boot time, the entry is 
marked old. This field is useful when trying to determine whether a 
person is working at the terminal or not. The pid is the process-ID 
of the user's shell. The comment is the comment field associated 
with this line as found in /etc/inittab (see inittab{5)). This can 
contain information about where the terminal is located, the tele¬ 
phone number of the dataset, type of terminal if hard-wired, etc. 

-T This option causes the state of the terminal line to be printed. The 
state describes whether someone else can write to that terminal. A 
+ appears if the terminal is writable by anyone; a — appears if it is 
not. Root can write to all lines having a + or a — in the state field. 
If a bad line is encountered, a ? is printed. 

—1 This option lists only those lines on which the system is waiting for 
someone to login. The name field is LOGIN in such cases. Other 
fields are the same as for user entries except that the state field 
doesn't exist. 

—p This option lists any other process which is currently active and 
has been previously spawned by init. The name field is the name of 
the program executed by init as found in /etc/inittab. The state, 
line, and activity fields have no meaning. The comment field shows 
the id field of the line from /etc/inittab that spawned this process. 
See inittab{5). 
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—d This option displays all processes that have expired and not been 
respawned by init. The exit field appears for dead processes and 
contains the termination and exit values (as returned by wait{2)), 
of the dead process. This can be useful in determining why a pro¬ 
cess terminated. 

—b This option indicates the time and date of the last reboot. 

—r This option indicates the current run-Level of the init process. Fol¬ 

lowing the run-level and date information are three fields which 
indicate the current state, the number of times that state was pre¬ 
viously entered, and the previous state. 

-I This option indicates the last change to the system clock (via the 
date{l) command) by root. See su(l). 

—a This option processes /etc/utmp or the named file with all options 
turned on. 

—s This option is the default and lists only the name, Line and time 

fields. 


FILES 

/etc/utmp 

/etc/wtmp 

/etc/inittab 

SEE ALSO 

date(l). login(l). mesg(l). su(l). wait(2). inittab(5). utmp(5), init(8). 
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NAME 

write — write to another user 

SYNOPSIS 

write user [ line ] 

DESCRIPTION 

Write copies lines from your terminal to that of another user. When first 
called, it sends the message: 

Message fromyoumame (tty??) [ date ]... 

to the person you want to talk to. When it has successfully completed 
the connection it also sends two bells to your own terminal to indicate 
that what you are typing is being sent. 

The recipient of the message should write back at this point. Communi¬ 
cation continues until an end of file is read from the terminal or an 
interrupt is sent. At that point unrite writes EOT on the other terminal 
and exits. 

If you want to write to a user who is logged in more than once, the Line 
argument may be used to indicate which line or terminal to send to (e.g., 
ttyOO); otherwise, the first instance of the user found in /etc/ulmp is 
assumed and the following message posted: 

user is logged on more than one place. 

You are connected to "terminal". 

Other locations are: 
terminal 

Permission to write may be denied or granted by use of the mesg(l) com¬ 
mand. Writing to others is normally allowed by default. Certain com¬ 
mands, in particular nrojf{l) and pr(l) disallow messages in order to 
prevent interference with their output. However, if the user has super- 
user permissions, messages can be forced onto a write inhibited terminal. 

If the character ! is found at the beginning of a line, write calls the shell 
to execute the rest of the line as a command. 

The following protocol is suggested for using write: when you first unnte 
to another user, wait for them to write back before starting to send. 
Each person should end a message with a distinctive signal (i.e., (o) for 
"over") so that the other person knows when to reply. The signal (oo) 
(for "over and out”) is suggested when conversation is to be terminated. 

FILES 

/etc/utmp to find user 
/bin/sh to execute! 

SEE ALSO 

mail(l), mesg(l), nrofT(l). pr(l), sh(l), who(l). 

DIAGNOSTICS 

"user not logged in" if the person you are trying to write to is not logged 
in. 
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NAME 

xargs - construct argument list(s) and execute command 
SYNOPSIS 

xargs [flags] [ command [initial-arguments] ] 

DESCRIPTION 

Xargs combines the fixed initial-arguments with arguments read from 
standard input to execute the specified command one or more times. 
The number of arguments read for each command invocation and the 
manner in which they are combined are determined by the flags 
specified. 

Command, which may be a shell file, is searched for, using one's SPATH. If 
command is omitted, /bin/echo is used. 

Arguments read in from standard input are defined to be contiguous 
strings of characters delimited by one or more blanks, tabs, or new-lines; 
empty lines are always discarded. Blanks and tabs may be embedded as 
part of an argument if escaped or quoted; Characters enclosed in quotes 
(single or double) are taken literally, and the delimiting quotes are 
removed. Outside of quoted strings a backslash (\) will escape the next 
character. 


Each argument list is constructed starting with the initial-arguments, 
followed by some number of arguments read from standard input (Excep¬ 
tion: see —i flag). Flags —i, —1, and —n determine how arguments are 
selected for each command invocation. When none of these flags are 
coded, the initial-arguments are followed by arguments read continu¬ 
ously from standard input until an internal buffer is full, and then com¬ 
mand is executed with the accumulated args. This process is repeated 
until there are no more args. When there are flag conflicts (e.g., —1 vs. 
—n), the last flag has precedence. Flag values are: 

—Inumber Command is executed for each non-empty number 

lines of arguments from standard input. The last invo¬ 
cation of command will be with fewer lines of argu¬ 
ments if fewer than number remain. A line is con¬ 
sidered to end with the first new-line unless the last 
character of the line is a blank or a tab; a trailing 
blank/tab signals continuation through the next non¬ 
empty line. If number is omitted 1 is assumed. Option 
—X is forced. 

—ireplstr Insert mode; command is executed for each line from 

standard input, taking the entire line as a single arg, 
inserting it in initial-arguments for each occurrence 
of replstr. A maximum of 5 arguments in initial- 
arguments may each contain one or more instances of 
replstr. Blanks and tabs at the beginning of each line 
are thrown away. Constructed arguments may not 
grow larger than 255 characters, and option —x is also 
forced. ( j is assumed for replstr if not specified. 


—nnumber Execute command using as many standard input argu¬ 

ments as possible, up to number arguments maximum. 
Fewer arguments will be used if their total size is 


Page 1 


February 20, 1984 







MUNIX 


XARGS(l) 


XARGS(1) 


-t 


-P 


—X 


—ssize 


greater than size characters, and for the last invoca¬ 
tion if there are fewer than number arguments 
remaining. If option —x is also coded, each number 
arguments must fit in the size limitation, else xargs 
terminates execution. 

Trace mode: The command and each constructed 
argument list are echoed to file descriptor 2 just prior 
to their execution. 

Prompt mode: The user is asked whether to execute 
command each invocation. Trace mode (—t) is turned 
on to print the command instance to be executed, fol¬ 
lowed by a ?... prompt. A reply of y (optionally fol¬ 
lowed by anything) will execute the command; any¬ 
thing else, including just a carriage return, skips that 
particular invocation of command. 

Causes xargs to terminate if any argument list would 
be greater than size characters: —x is forced by the 
options —i and —1. When neither of the options —i, —1. 
or —n are coded, the total length of all arguments 
must be within the size limit. 

The maximum total size of each argument list is set to 
size characters: size must be a positive integer less 
than or equal to 470. If —s is not coded, 470 is taken as 
the default. Note that the character count for size 
includes one extra character for each argument and 
the count of characters in the command name. 


—eeofstr Eofstr is taken as the logical end-of-file string. Under¬ 

bar (_) is assumed for the logical EOF string if —e is 
not coded. —e with no eofstr coded turns off the logi¬ 
cal EOF string capability (underbar is taken literally). 
Xargs reads standard input until either end-of-file or 
the logical EOF string is encountered. 

Xargs will terminate if either it receives a return code of —1 from, or if it 
cannot execute, command. When command is a shell program, it should 
explicitly exit (see s/i(l)) with an appropriate value to avoid accidentally 
returning with —1. 


EXAMPLES 

The following will move all files from directory Si to directory S2. and 
echo each move command just before doing it: 

Is $1 1 xargs —i —t mv Sl/| { S2/| j 


The following will combine the output of the parenthesized commands 
onto one line, which is then echoed to the end of file log: 


(logname; date; echo SO S*) | xargs >>log 

The user is asked which files in the current directory are to be archived 
and archives them into arch (1.) one at a time, or (2.) many at a time. 

1. Is I xargs —p —1 ar r arch 

2. Is 1 xargs —p —1 1 xargs ar r arch 
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The following will execute with successive pairs of arguments ori¬ 

ginally typed as shell arguments; 

echo S* I xargs —n2 difT 

DIAGNOSTICS 

Self explanatory. 
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NAME 

xd — hexadecimal dump 
SYNOPSIS 

xd [ file ] [ olTsetl[ • ][ b ] [ - [ofTset2[ . ][ b ] ] 

DESCRIPTION 

Xd dumps file in hexadecimal and as characters. 

The file argument specifies which file is to be dumped. If no file argu¬ 
ment is specified, the standard input is used. 

The offset argument specifies the offset in the file where dumping is to 
commence. This argument is normally interpreted as hexadecimal bytes. 
If it starts with 'O’, the offset is interpreted in octal. If is appended, the 
offset is interpreted in decimal. If 'b' is appended, the offset is inter¬ 
preted in blocks of 512 bytes. If the file argument is omitted, the offset 
argument must be preceded 

If no second offset is specified, dumping continues until end-of-file. Oth¬ 
erwise dumping ends before the specified endaddress. The interpretation 
of offsets is the same as above. 

SEE ALSO 

adb(l) 
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NAME 

xref — cross-reference listing 

SYNOPSIS 

xref [-c] [-p] [-P] 

DESCRIPTION 

Are/creates a cross-reference listing from the standard input. 

It lists on the standard output the alphabetic sorted identifiers followed 
by the linenumbers in which they appear. 

-c C comments will be skipped 
-p Pascal comments will be skipped 

-P Packed files will be processed. The filenames are prepended to the 
linenumbers. 

Unpacked input files are listed without filenames. 

EXAMPLE 

pack ack.p fac.p 1 xref -p -P 
outputs; 


var 

ack.p 

2 

fac.p 

3 



writeln 

ack.p 

12 

14 

fac.p 

10 

12 

X 

ack.p 

2 

13 

14 

14 

15 


fac.p 

3 

11 

12 

12 

13 

y 

ack.p 

2 

13 

14 

14 



SEE ALSO 

pack(l). 


Page 1 


February 20, 1984 
















XSTR(1) 


MUNIX 


XSTR(l) 


NAME 

xstr — extract strings from C programs to implement shared strings 
SYNOPSIS 

xstr [ —c ] [ — ] [ file ] 

DESCRIPTION 

Xstr maintains a file strings into which strings in component parts of a 
large program are hashed. These strings are replaced with references to 
this common area. This serves to implement shared constant strings, 
most useful if they are also read-only. 

The command 

xstr —c name 

will extract the strings from the C source in name, replacing string refer¬ 
ences by expressions of the form (&xstr[number]) for some number. An 
appropriate declaration of xstr is prepended to the file. The resulting C 
text is placed in the file i.c, to then be compiled. The strings from this 
file are placed in the strings data base if they are not there already. 
Repeated strings and strings which are suffices of existing strings do not 
cause changes to the data base. 

After all components of a large program have been compiled a file xs.c 
declaring the common xstr space can be created by a command of the 
form 


xstr 


This xs.c file should then be compiled and loaded with the rest of the pro¬ 
gram. If possible, the array can be made read-only (shared) saving space 
and swap overhead. 

Xstr can also be used on a single file. A command 
xstr name 

creates files x.c and xs.c as before, without using or affecting any strings 
file in the same directory. 

It may be useful to run xstr after the C preprocessor if any macro 
definitions yield strings or if there is conditional code which contains 
strings which may not, in fact, be needed. Xstr reads from its standard 
input when the argument ’ is given. An appropriate command sequence 
for running xstr after the C preprocessor is: 

cc'—E name.c [ xstr —c — 
cc —c x.c 
mvx.oname.o 

Xstr does not touch the file strings unless new items are added, thus 
make can avoid remaking xs.o unless truly necessary. 


FILES 


strings 

x.c 

xs.c 

/tmp/xs* 


Data base of strings 
Massaged C source 
C source for definition of array ’xstr’ 

Temp file when 'xstr name’ doesn't touch strings 


Page 1 


February 20, 1984 











XSTR(l) 


MUNIX 


XSTR(l) 


SEE ALSO 

mkstr(l) 

AUTHOR 

William Joy 

BUGS 

If a string is a suffix of another string in the data base, but the shorter 
string is seen first by xstr both strings will be placed in the data base, 
when just placing the longer one there will do. 
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NAME 

yacc — yet another compiler-compiler 
SYNOPSIS 

yacc [ —vd ] grammar 
DESCRIPTION 

Yacc converts a context-free grammar into a set of tables for a simple 
automaton which executes an LR(1) parsing algorithm. The grammar 
may be ambiguous; specified precedence rules are used to break ambi¬ 
guities. 

The output file, y.tab.c, must be compiled by the C compiler to produce a 
program yyparse. This program must be loaded with the lexical analyzer 
program, yylex, as well as main and yyerror, an error handling routine. 
These routines must be supplied by the user; Lex{l) is useful for creating 
lexical analyzers usable by yacc. 

If the —V flag is given, the file y.output is prepared, which contains a 
description of the parsing tables and a report on conflicts generated by 
ambiguities in the grammar. 

If the —d flag is used, the file y.tab.h is generated with the define state¬ 
ments that associate the yacc-assigned 'token codes’ with the user- 
declared ‘token names’. This allows source files other than y.tab.c to 
access the token codes. 

FILES 

y.output 

y.tab.c 

y.tab.h defines for token names 

yacc.tmp, yacc.acts temporary files 
/usr/lib/yaccpar parser prototype for C programs 
/usr/lib/liby.a library with default ’main’ and ’yyerror’ 

SEE ALSO 

Zei( 1) 

LR Parsing by A. V. Aho and S. C. Johnson. Computing Surveys. June, 
1974. 

YACC— Yet Another Compiler Compiler by S. C. Johnson. 

DIAGNOSTICS 

The number of reduce-reduce and shift-reduce conflicts is reported on 
the standard output; a more detailed report is found in the y.output file. 
Similarly, if some rules are not reachable from the start symbol, this is 
also reported. 

BUGS 

Because file names are fixed, at most one yacc process can be active in a 
given directory at a time. 
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NAME 

yes — be repetitively affirmative 

SYNOPSIS 

yes [ expletive ] 

DESCRIPTION 

Yes repeatedly outputs y. or if expletive is given, that is output repeat¬ 
edly. Termination is by rubout. 

EXAMPLE 

"yes 1 fsck” would be the same as "fsck -y". 
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